Get Current User's Profile

Developing

GET

/me

category-users-profile

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

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.spotify.com/v1/me' \
--header 'Authorization;'

Response Example

200 - Example 1

{
    "country": "string",
    "display_name": "string",
    "email": "string",
    "explicit_content": {
        "filter_enabled": true,
        "filter_locked": true
    },
    "external_urls": {
        "spotify": "string"
    },
    "followers": {
        "href": "string",
        "total": 0
    },
    "href": "string",
    "id": "string",
    "images": [
        {
            "height": 0,
            "url": "string",
            "width": 0
        }
    ],
    "product": "string",
    "type": "string",
    "uri": "string"
}

Request

Header Params

Authorization

string

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, product subscription level and explicit content settings requires the user-read-private scope. See Using Scopes.

Responses

🟢200On success, the HTTP status code in the response header is `200` OK and the response body contains a [user object](https://developer.spotify.com/documentation/web-api/reference/#object-privateuserobject) in JSON format. On error, the header status code is

application/json

Body

country

string

optional

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

optional

The name displayed on the user's profile. null if not available.

string

optional

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.

explicit_content

object (ExplicitContentSettingsObject)

optional

filter_enabled

boolean

optional

When true, indicates that explicit content should not be played.

filter_locked

boolean

optional

When true, indicates that the explicit content setting is locked and can't be changed by the user.

external_urls

object (ExternalUrlObject)

optional

spotify

string

optional

The Spotify URL for the object.

followers

object (FollowersObject)

optional

href

string

optional

A link to the Web API endpoint providing full details of the followers; null if not available. Please note that this will always be set to null, as the Web API does not support it at the moment.

total

integer <int32>

optional

The total number of followers.

href

string

optional

A link to the Web API endpoint for this user.

string

optional

The Spotify user ID for the user.

images

array[object (ImageObject) {3}]

optional

The user's profile image.

height

integer <int32>

optional

The image height in pixels.

url

string

optional

The source URL of the image.

width

integer <int32>

optional

The image width in pixels.

product

string

optional

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

optional

The object type: "user"

uri

string

optional

The Spotify URI for the user.

🔴500500

Get Available Markets

Get a User's Profile