Get public profile information about a Spotify user.
Endpoint
GET https://api.spotify.com/v1/users/{user_id}
Request Parameters
| Path element | Value |
|---|---|
| user_id | The user's Spotify user ID. |
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. If a user with that user_id doesn’t exist, the status code is 404 NOT FOUND.
Example
curl -X GET "https://api.spotify.com/v1/users/tuggareutangranser"
{
"display_name" : "Lilla Namo",
"external_urls" : {
"spotify" : "https://open.spotify.com/user/tuggareutangranser"
},
"followers" : {
"href" : null,
"total" : 4561
},
"href" : "https://api.spotify.com/v1/users/tuggareutangranser",
"id" : "tuggareutangranser",
"images" : [ {
"height" : null,
"url" : "http://profile-images.scdn.co/artists/default/d4f208d4d49c6f3e1363765597d10c4277f5b74f",
"width" : null
} ],
"type" : "user",
"uri" : "spotify:user:tuggareutangranser"
}
user object (public)
| Key | Value Type | Value Description |
|---|---|---|
| display_name | string | The name displayed on the user's profile. |
| external_urls | an external URL object | Known public external URLs for this user. |
| followers | A followers object | Information about the followers of this user. |
| href | string | A link to the Web API endpoint for this user. |
| id | string | The Spotify user ID for this user. |
| images | array of image objects | The user's profile image. |
| type | string | The object type: "user" |
| uri | string | The Spotify URI for this user. |