Endpoint

GET https://api.spotify.com/v1/me/albums

Request Parameters

Header Fields

Header Field Value
Authorization Required. A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details. The user-library-read scope must have been authorized by the user.

Query Parameters

Query Parameter Value
limit Optional. The maximum number of objects to return. Default: 20. Minimum: 1. Maximum: 50.
offset Optional. The index of the first object to return. Default: 0 (i.e., the first object). Use with limit to get the next set of objects.
market Optional. An ISO 3166-1 alpha-2 country code or the string from_token. Provide this parameter if you want to apply Track Relinking.

Response Format

On success, the HTTP status code in the response header is 200 OK and the response body contains an array of album objects (wrapped in a paging object) in JSON format. Each album object is accompanied by a timestamp (added_at) to show when it was added. There is also an etag in the header that can be used in future conditional requests.

On error, the header status code is an error code and the response body contains an error object.

Example

curl -X GET "https://api.spotify.com/v1/me/albums" -H "Authorization: Bearer {your access token}"
{
  "href" : "https://api.spotify.com/v1/me/albums?offset=0&limit=1",
  "items" : [ {
    "added_at" : "2015-11-26T19:13:31Z",
    "album" : {
      "album_type" : "album",
      "artists" : [ {
        "external_urls" : {
          "spotify" : "https://open.spotify.com/artist/58RMTlPJKbmpmVk1AmRK3h"
        },
        "href" : "https://api.spotify.com/v1/artists/58RMTlPJKbmpmVk1AmRK3h",
        "id" : "58RMTlPJKbmpmVk1AmRK3h",
        "name" : "Abidaz",
        "type" : "artist",
        "uri" : "spotify:artist:58RMTlPJKbmpmVk1AmRK3h"
      } ],
      "available_markets" : [ "AR", "AT", "AU", "BE", "BR", "CL", "CO", "CY", "CZ", "DE" ],
      "copyrights" : [ {
        "text" : "(C) 2013 Soblue Music Group AB, Under exclusive license to Universal Music AB",
        "type" : "C"
      }, {
        "text" : "(P) 2013 Soblue Music Group AB, Under exclusive license to Universal Music AB",
        "type" : "P"
      } ],
      "external_ids" : {
        "upc" : "00602537623730"
      },
      "external_urls" : {
        "spotify" : "https://open.spotify.com/album/5m4VYOPoIpkV0XgOiRKkWC"
      },
      "genres" : [ ],
      "href" : "https://api.spotify.com/v1/albums/5m4VYOPoIpkV0XgOiRKkWC",
      "id" : "5m4VYOPoIpkV0XgOiRKkWC",
      "images" : [ {
        "height" : 640,
        "url" : "https://i.scdn.co/image/ccbb1e3bea2461e69783895e880965b171e29f4c",
        "width" : 640
      }, {
        "height" : 300,
        "url" : "https://i.scdn.co/image/2210b7d23f320a2cab2736bd3b3b948415dd21d8",
        "width" : 300
      }, {
        "height" : 64,
        "url" : "https://i.scdn.co/image/609153aca7f4760136d97fbaccdb4ec0757e4c9e",
        "width" : 64
      } ],
      "name" : "In & ut",
      "popularity" : 49,
      "release_date" : "2013-01-01",
      "release_date_precision" : "day",
      "tracks" : {
        "href" : "https://api.spotify.com/v1/albums/5m4VYOPoIpkV0XgOiRKkWC/tracks?offset=0&limit=50",
        "items" : [ {
          "artists" : [ {
            "external_urls" : {
              "spotify" : "https://open.spotify.com/artist/58RMTlPJKbmpmVk1AmRK3h"
            },
            "href" : "https://api.spotify.com/v1/artists/58RMTlPJKbmpmVk1AmRK3h",
            "id" : "58RMTlPJKbmpmVk1AmRK3h",
            "name" : "Abidaz",
            "type" : "artist",
            "uri" : "spotify:artist:58RMTlPJKbmpmVk1AmRK3h"
          }, {
            "external_urls" : {
              "spotify" : "https://open.spotify.com/artist/1l63szZeUpN1m87MOD1u7K"
            },
            "href" : "https://api.spotify.com/v1/artists/1l63szZeUpN1m87MOD1u7K",
            "id" : "1l63szZeUpN1m87MOD1u7K",
            "name" : "Chapee",
            "type" : "artist",
            "uri" : "spotify:artist:1l63szZeUpN1m87MOD1u7K"
          }, {
            "external_urls" : {
              "spotify" : "https://open.spotify.com/artist/1VLf7Ncxb5Jga6eyd3jh6K"
            },
            "href" : "https://api.spotify.com/v1/artists/1VLf7Ncxb5Jga6eyd3jh6K",
            "id" : "1VLf7Ncxb5Jga6eyd3jh6K",
            "name" : "C.U.P",
            "type" : "artist",
            "uri" : "spotify:artist:1VLf7Ncxb5Jga6eyd3jh6K"
          } ],
          "available_markets" : [ "AR", "AT", "AU", "BE", "BR", "CL", "CO", "CY", "CZ", "DE" ],
          "disc_number" : 1,
          "duration_ms" : 170920,
          "explicit" : false,
          "external_urls" : {
            "spotify" : "https://open.spotify.com/track/3VNWq8rTnQG6fM1eldSpZ0"
          },
          "href" : "https://api.spotify.com/v1/tracks/3VNWq8rTnQG6fM1eldSpZ0",
          "id" : "3VNWq8rTnQG6fM1eldSpZ0",
          "name" : "E.C.",
          "preview_url" : "https://p.scdn.co/mp3-preview/f95e0dba1a76b44fa2b52da2bc273d4f1c4126a5",
          "track_number" : 1,
          "type" : "track",
          "uri" : "spotify:track:3VNWq8rTnQG6fM1eldSpZ0"
        }, {
          ...
        }, {
          "artists" : [ {
            "external_urls" : {
              "spotify" : "https://open.spotify.com/artist/58RMTlPJKbmpmVk1AmRK3h"
            },
            "href" : "https://api.spotify.com/v1/artists/58RMTlPJKbmpmVk1AmRK3h",
            "id" : "58RMTlPJKbmpmVk1AmRK3h",
            "name" : "Abidaz",
            "type" : "artist",
            "uri" : "spotify:artist:58RMTlPJKbmpmVk1AmRK3h"
          } ],
          "available_markets" : [ "AR", "AT", "AU", "BE", "BR", "CL", "CO", "CY", "CZ", "DE", "DK", "EE" ],
          "disc_number" : 1,
          "duration_ms" : 165946,
          "explicit" : false,
          "external_urls" : {
            "spotify" : "https://open.spotify.com/track/6ZrVKylVlxkaXHj42O0q2r"
          },
          "href" : "https://api.spotify.com/v1/tracks/6ZrVKylVlxkaXHj42O0q2r",
          "id" : "6ZrVKylVlxkaXHj42O0q2r",
          "name" : "Råknas - Radio Edit",
          "preview_url" : "https://p.scdn.co/mp3-preview/a7c9a4bfa9e346e3733e9d88076ad1ae409136fb",
          "track_number" : 13,
          "type" : "track",
          "uri" : "spotify:track:6ZrVKylVlxkaXHj42O0q2r"
        } ],
        "limit" : 50,
        "next" : null,
        "offset" : 0,
        "previous" : null,
        "total" : 13
      },
      "type" : "album",
      "uri" : "spotify:album:5m4VYOPoIpkV0XgOiRKkWC"
    }
  } ],
  "limit" : 1,
  "next" : "https://api.spotify.com/v1/me/albums?offset=1&limit=1",
  "offset" : 0,
  "previous" : null,
  "total" : 19
}

Try it

saved album object

Key Value Type Value Description
added_at a timestamp The date and time the album was saved.
album a album object Information about the album.

paging object

Key Value Type Value Description
href string A link to the Web API endpoint returning the full result of the request.
items an array of objects The requested data.
limit integer The maximum number of items in the response (as set in the query or by default).
next string URL to the next page of items. ( null if none)
offset integer The offset of the items returned (as set in the query or by default).
previous string URL to the previous page of items. ( null if none)
total integer The total number of items available to return.