Example request

GET https://api.7digital.com/1.2/artist/releases?artistid=1&oauth_consumer_key=YOUR_KEY_HERE&country=GB&pagesize=2&usageTypes=download,subscriptionstreaming,adsupportedstreaming

Example response

{
   "status": "ok",
   "version": "1.2",
   "schema": "http://api.7digital.com/1.2/static/7digitalAPI.xsd",
   "releases": {
      "page": 1,
      "pageSize": 2,
      "totalItems": 59,
      "releases": [
         {
            "id": 809798,
            "title": "A Bad Dream",
            "version": "",
            "type": "Single",
            "barcode": "00602527390970",
            "year": "2010",
            "explicitContent": false,
            "artist": {
               "id": 1,
               "name": "Keane",
               "appearsAs": "Keane",
               "image": "http://artwork-cdn.7static.com/static/img/artistimages/00/000/000/0000000001_150.jpg",
               "slug": "keane",
               "isPlaceholderImage": true
            },
            "image": "http://artwork-cdn.7static.com/static/img/sleeveart/00/008/097/0000809798_50.jpg",
            "label": {
               "id": 471977,
               "name": "(P) 2010 Universal Island Records Ltd. A Universal Music Company."
            },
            "licensor": {
               "id": 1,
               "name": "Universal"
            },
            "popularity": 0,
            "duration": 307,
            "trackCount": 1,
            "download": {
               "releaseDate": "2015-11-15T00:00:00Z",
               "packages": [
                  {
                     "id": 2,
                     "description": "Standard",
                     "price": {
                        "currencyCode": "GBP",
                        "sevendigitalPrice": 0.99,
                        "recommendedRetailPrice": 0.99
                     },
                     "formats": [
                        {
                           "id": 17,
                           "description": "MP3 320"
                        }
                     ]
                  },
                  {
                     "id": 9,
                     "description": "Premium",
                     "price": {
                       "currencyCode": "GBP",
                       "sevendigitalPrice": 0.99,
                       "recommendedRetailPrice": 0.99
                     },
                     "formats": [
                       {
                         "id": 45,
                         "description": "FLAC 16-bit 44.1kHz"
                       }
                     ]
                  }
               ]
            },
            "subscriptionStreaming": {
               "releaseDate": "2015-11-15T00:00:00Z"
            },
            "adSupportedStreaming": {
               "releaseDate": "2015-11-15T00:00:00Z"
            },
            "slug": "a-bad-dream-1"
         },
         {
            "id": 470,
            "title": "AOL Session",
            "version": "",
            "type": "Single",
            "barcode": "00602498672938",
            "year": "2004",
            "explicitContent": false,
            "artist": {
               "id": 1,
               "name": "Keane",
               "appearsAs": "Keane",
               "image": "http://artwork-cdn.7static.com/static/img/artistimages/00/000/000/0000000001_150.jpg",
               "slug": "keane",
               "isPlaceholderImage": true
            },
            "image": "http://artwork-cdn.7static.com/static/img/sleeveart/00/000/004/0000000470_50.jpg",
            "label": {
               "id": 465499,
               "name": "(P) 2004 Universal Island Records Ltd. A Universal Music Company."
            },
            "licensor": {
               "id": 1,
               "name": "Universal"
            },
            "popularity": 0,
            "duration": 1404,
            "trackCount": 6,
            "download": {
               "releaseDate": "2015-11-15T00:00:00Z",
               "packages": [
                  {
                     "id": 2,
                     "description": "Standard",
                     "price": {
                        "currencyCode": "GBP",
                        "sevendigitalPrice": 3.99,
                        "recommendedRetailPrice": 3.99
                     },
                     "formats": [
                        {
                           "id": 17,
                           "description": "MP3 320"
                        },
                        {
                           "id": 33,
                           "description": "AAC 320"
                        }
                     ]
                  }
               ]
            },
            "subscriptionStreaming": {
               "releaseDate": "2015-11-15T00:00:00Z"
            },
            "adSupportedStreaming": {
               "releaseDate": "2015-11-15T00:00:00Z"
            },
            "slug": "aol-session"
         }
      ]
   }
}

For each response data associated with each release, please refer to Release Details.

Specific Error Codes

HTTP: 1001 - Required parameter artistId is missing. You must supply a value for the artistId parameter.
HTTP: 1003 - Requested page out of range. You specified a page number which does not exist..