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

Endpoint

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

Request Parameters

Header field
Value
Authorization
Required. A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details. The access token must have been issued on behalf of the current user.

Reading the user's email address requires the user-read-email scope; reading country and product subscription level requires the user-read-private scope. Reading the user's birthdate requires the user-read-birthdate scope. See Using Scopes.

Response Format

On success, the HTTP status code in the response header is 200 OK and the response body contains a user object in JSON format. On error, the header status code is an error code and the response body contains an error object. When requesting fields that you don’t have the user’s authorization to access, it will return error 403 Forbidden.

Important! If the user-read-email scope is authorized, the returned JSON will include the email address that was entered when the user created their Spotify account. This email address is unverified; do not assume that Spotify has checked that email address actually belongs to the user.

Example

curl -X GET "https://api.spotify.com/v1/me" -H "Authorization: Bearer {your access token}"
{
  "birthdate": "1937-06-01",
  "country": "SE",
  "display_name": "JM Wizzler",
  "email": "email@example.com",
  "external_urls": {
    "spotify": "https://open.spotify.com/user/wizzler"
  },
  "followers" : {
    "href" : null,
    "total" : 3829
  },
  "href": "https://api.spotify.com/v1/users/wizzler",
  "id": "wizzler",
  "images": [
    {
      "height": null,
      "url": "https://fbcdn-profile-a.akamaihd.net/hprofile-ak-frc3/t1.0-1/1970403_10152215092574354_1798272330_n.jpg",
      "width": null
    }
  ],
  "product": "premium",
  "type": "user",
  "uri": "spotify:user:wizzler"
}

Try it in our Web API Console

user object (private)

Key
Value Type
Value Description
birthdatestringThe user's date-of-birth.

This field is only available when the current user has granted access to the user-read-birthdate scope.
countrystringThe 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_namestringThe name displayed on the user's profile.
emailstringThe 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.
external_urlsan external URL objectKnown external URLs for this user.
followersA followers objectInformation about the followers of the user.
hrefstringA link to the Web API endpoint for this user.
id
string
The Spotify user ID for the user.
imagesan array of image objectsThe user's profile image.
product
string
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.
type
string
The object type: "user"
uristringThe Spotify URI for the user.