Web APIReferences / Users / Get Current User's Profile

Get Current User's Profile

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

Authorization scopes

Request

GET/me

Response

A user

  • account_idstring

    A public, immutable, pseudoanonymous identifier for the user's account. Use this field for account linking rather than the id field, as it is stable and will not change over the lifetime of the account.

    Example: "aB3dE5fG7h"
  • countrystring
    Deprecated

    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_namestring

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

  • emailstring
    Deprecated

    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.

  • Deprecated

    The user's explicit content settings. This field is only available when the current user has granted access to the user-read-private scope.

    • filter_enabledboolean

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

    • filter_lockedboolean

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

  • Known external URLs for this user.

  • Deprecated

    Information about the followers of the user.

    • hrefstring
      Nullable

      This will always be set to null, as the Web API does not support it at the moment.

    • totalinteger

      The total number of followers.

  • hrefstring

    A link to the Web API endpoint for this user.

  • idstring

    The Spotify user ID for the user. Do not use this field for account linking — use account_id instead, which is immutable.

  • The user's profile image.

    • urlstring
      Required

      The source URL of the image.

      Example: "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228"
    • heightinteger
      Required
      Nullable

      The image height in pixels.

      Example: 300
    • widthinteger
      Required
      Nullable

      The image width in pixels.

      Example: 300
  • productstring
    Deprecated

    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.

  • typestring

    The object type: "user"

  • uristring

    The Spotify URI for the user.

endpointhttps://api.spotify.com/v1/me

Response sample

{  "account_id": "aB3dE5fG7h",  "country": "string",  "display_name": "string",  "email": "string",  "explicit_content": {    "filter_enabled": false,    "filter_locked": false  },  "external_urls": {    "spotify": "string"  },  "followers": {    "href": "string",    "total": 0  },  "href": "string",  "id": "string",  "images": [    {      "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228",      "height": 300,      "width": 300    }  ],  "product": "string",  "type": "string",  "uri": "string"}