Users

Get Current User's Profile

Changed on

Get detailed profile information about the current user (including the current user's username).

get/me

Request

  • Base URL
    https://api.spotify.com/v1
  • URL
    https://api.spotify.com/v1/me
  • Auth
    OAuth 2
    Authorization code: https://accounts.spotify.com/authorize
    Token URL: https://accounts.spotify.com/api/token scopes: user-read-private, user-read-email

Response

A user

account_idstring

A public, immutable, pseudoanonymous identifier for the user's account. Use this field for account linking rather than the id field, as it is stable and will not change over the lifetime of the account.

countrystring

The country of the user, as set in the user's account profile. An ISO 3166-1 alpha-2 country code. This field is only available when the current user has granted access to the user-read-private scope.

display_namestring

The name displayed on the user's profile. null if not available.

emailstring

The user's email address, as entered by the user when creating their account. Important! This email address is unverified; there is no proof that it actually belongs to the user. This field is only available when the current user has granted access to the user-read-email scope.

hrefstring

A link to the Web API endpoint for this user.

idstring

The Spotify user ID for the user. Do not use this field for account linking — use account_id instead, which is immutable.

productstring

The user's Spotify subscription level: "premium", "free", etc. (The subscription level "open" can be considered the same as "free".) This field is only available when the current user has granted access to the user-read-private scope.

typestring

The object type: "user"

uristring

The Spotify URI for the user.

Example response

{
  "account_id": "aB3dE5fG7h",
  "images": [
    {
      "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
      "height": 300,
      "width": 300
    }
  ]
}

Changes

  • 2d888d731358Revision changes
    • info

      added the optional property to the response with the status

  • 8899d6fd66eeRevision changes
    • info

      response property country deprecated

    • info

      response property email deprecated

    • info

      response property explicit_content deprecated

    • info

      response property followers deprecated

    • info

      response property product deprecated