Skip to content
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"}