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

Try it in our Web API Console

user object (public)

Key
Value Type
Value Description
display_namestringThe name displayed on the user's profile.
external_urlsan external URL objectKnown public external URLs for this user.
followersA followers objectInformation about the followers of this user.
hrefstringA link to the Web API endpoint for this user.
id
string
The Spotify user ID for this user.
imagesarray of image objectsThe user's profile image.
type
string
The object type: "user"
uristringThe Spotify URI for this user.