v1

latestOpenAPI 3.0.32026-07-139687282.9 KB
Users

Get Current User's Profile

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

get/me

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
    }
  ]
}