GET ​/api​/v3​/account​/me​/artist_profile

Retrieve an artist profile for this account.

Request

Example Request

{
  "auth_token": "abc1245920feab98ca"
}

Example Parameters

  • auth_token: The user's auth_token obtained by calling the auth API. If provided, the response will indicate follow status for elements in the followers array.
    • Required: yes
    • Type: string
    • Example: abc1245920feab98ca

Response

Example Response

{
  "artist_profile": {
    "id": 1,
    "name": "The Rolling Stones",
    "slug": "rolling-stones",
    "facebook_url": "http://www.facebook.com/rollingstones",
    "location": {
      "id": {
      },
      "city": "Houston",
      "province": "TX",
      "country": "US",
      "lat": 29.763033,
      "lng": -95.363305
    },
    "genres": [
      "Rock"
    ],
    "url": "http://www.therollingstones.com/",
    "twitter_handle": "rollingstones",
    "bio": "Funky towns best ensemble",
    "active": true,
    "photos": null
  }
}

Response Parameters

  • artist_profile: The artist_profile object containing the attributes for the artist profile.

    • Required: yes
    • id: The unique ID of the artist profile. This is not the account ID.
      • Required: yes
      • Type: integer
      • Example: 1
    • name: The name of the artist
      • Required: yes
      • Type: string
      • Example: The Rolling Stones
    • slug: The unique slug for an artist
      • Required: yes
      • Type: string
      • Example: rolling-stones
    • facebook_url: The facebook url for the artist
      • Required: yes
      • Type:
        • null
        • string
      • Example: http://www.facebook.com/rollingstones
    • location: The hometown location of the artist.

      • Required: yes
      • id:

        • Required: yes
        • Type: Integer
        • Example: 1
      • city:

        • Required: yes
        • Type: string
        • Example: Houston
      • province:

        • Required: yes
        • Type: string
        • Example: TX
      • country:

        • Required: yes
        • Type: string
        • Example: US
      • lat:

        • Required: yes
        • Type: number
        • Example: 29.763033
      • lng:

        • Required: yes
        • Type: number
        • Example: -95.363305
    • genres: Genres associated with the artist

      • Required: yes
      • Type: array
      • Items

        • Required: no
        • Type: string
        • Example: Rock
    • url: The URL to the artists website

      • Required: yes
      • Type:
        • null
        • string
      • Format: uri
      • Example: http://www.therollingstones.com/
    • twitter_handle: The twitter handle of the band

      • Required: yes
      • Type:
        • null
        • string
      • Example: rollingstones
    • bio: The artist biography

      • Required: yes
      • Type:
        • null
        • string
      • Example: Funky towns best ensemble
    • active: Whether or not the artist profile is active and visible in search results

      • Required: yes
      • Type: boolean
      • Example: true
    • photos: Photos of the artist

      • Required: no
      • Type:
        • null
        • array
      • Items

        • Required: no
        • id: The unique ID of the photo
          • Required: yes
          • Type: integer
          • Example: 1
        • description: A text description of the photo
          • Required: yes
          • Type: string
          • Example: Us looking mean in front of an abandoned warehouse
        • position: The sort position for this photo.
          • Required: no
          • Type: integer
          • Example: 1
        • small: A small non-retina artist photo

          • Required: yes
          • url: The URL to retrieve the photo
        • small_hq: A retina preview artist photo

          • Required: yes
          • url: The URL to retrieve the photo
        • medium: A medium sized artist photo

          • Required: yes
          • url: The URL to retrieve the photo
        • medium_hq: A medium retina sized artist photo

          • Required: yes
          • url: The URL to retrieve the artist photo
        • large: A large sized artist photo

          • Required: yes
          • url: The URL to retrieve the artist photo
        • large_hq: A fullscreen retina artist photo

          • Required: yes
          • url: The URL to retrieve the artist photo

Response Codes

Successful Response Codes

  • 200: The artist profile was successfully retrieved.

Failure Response Codes

  • 404: Indicates the account was not found.

  • 401: Unauthorized request. Indicates a missing or invalid auth_token.