Skip to content
DocumentationAPI Reference

Get Current User's Profile

MeRetrieveResponse Me.Retrieve(MeRetrieveParams?parameters, CancellationTokencancellationToken = default)
GET/me

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

ParametersExpand Collapse
MeRetrieveParams parameters
ReturnsExpand Collapse
class MeRetrieveResponse:
string ID

The Spotify user ID for the user.

string Country

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.

string DisplayName

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

string Email

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.

ExplicitContent ExplicitContent

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

Boolean FilterEnabled

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

Boolean FilterLocked

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

Boolean Published

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

ExternalUrlObject ExternalUrls

Known external URLs for this user.

Boolean Published

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

string Spotify

The Spotify URL for the object.

FollowersObject Followers

Information about the followers of the user.

string? Href

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

Boolean Published

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

Long Total

The total number of followers.

string Href

A link to the Web API endpoint for this user.

IReadOnlyList<ImageObject> Images

The user's profile image.

required Long? Height

The image height in pixels.

required string Url

The source URL of the image.

required Long? Width

The image width in pixels.

Boolean Published

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

string Product

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.

Boolean Published

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

string Type

The object type: "user"

string Uri

The Spotify URI for the user.

Get Current User's Profile

MeRetrieveParams parameters = new();

var me = await client.Me.Retrieve(parameters);

Console.WriteLine(me);
{
  "id": "id",
  "country": "country",
  "display_name": "display_name",
  "email": "email",
  "explicit_content": {
    "filter_enabled": true,
    "filter_locked": true,
    "published": true
  },
  "external_urls": {
    "published": true,
    "spotify": "spotify"
  },
  "followers": {
    "href": "href",
    "published": true,
    "total": 0
  },
  "href": "href",
  "images": [
    {
      "height": 300,
      "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
      "width": 300,
      "published": true
    }
  ],
  "product": "product",
  "published": true,
  "type": "type",
  "uri": "uri"
}
Returns Examples
{
  "id": "id",
  "country": "country",
  "display_name": "display_name",
  "email": "email",
  "explicit_content": {
    "filter_enabled": true,
    "filter_locked": true,
    "published": true
  },
  "external_urls": {
    "published": true,
    "spotify": "spotify"
  },
  "followers": {
    "href": "href",
    "published": true,
    "total": 0
  },
  "href": "href",
  "images": [
    {
      "height": 300,
      "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
      "width": 300,
      "published": true
    }
  ],
  "product": "product",
  "published": true,
  "type": "type",
  "uri": "uri"
}