Skip to content
Announcement:We are updating the criteria to be granted extended access to the Web API.
Please note that starting May 15, 2025 we’re introducing some changes to the way we provide Web API extended quota mode access. For more information, read here.
Web API •References / 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

  • 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. null if not available.

  • email
    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.

  • 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_enabled
      boolean

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

    • filter_locked
      boolean

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

  • Known external URLs for this user.

  • Information about the followers of the user.

    • href
      string
      Nullable

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

    • total
      integer

      The total number of followers.

  • href
    string

    A link to the Web API endpoint for this user.

  • id
    string

    The Spotify user ID for the user.

  • The user's profile image.

    • url
      string
      Required

      The source URL of the image.

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

      The image height in pixels.

      Example: 300
    • width
      integer
      Required
      Nullable

      The image width in pixels.

      Example: 300
  • 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.

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

Response sample

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