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"
}user object (private)
| Key | Value Type | Value Description |
|---|---|---|
| birthdate | string | The user's date-of-birth. This field is only available when the current user has granted access to the user-read-birthdate scope. |
| country | string | 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_name | string | The name displayed on the user's profile. |
| string | 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. |
|
| external_urls | an external URL object | Known external URLs for this user. |
| followers | A followers object | Information about the followers of the user. |
| href | string | A link to the Web API endpoint for this user. |
| id | string | The Spotify user ID for the user. |
| images | an array of image objects | The 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" |
| uri | string | The Spotify URI for the user. |