GET ​/api​/v3​/artist​/:id​/shows

Returns the shows for the artist. Defaults to upcoming shows in order of occurrence.

Response

Example Response

{
  "shows": [
    {
      "id": 81,
      "venue_id": 12,
      "artist_id": 1,
      "show_time": "2014-01-09 21:00:04 UTC",
      "ticket_url": "http://ticketschmaster.com/show123/buy"
    }
  ],
  "venues": [
    {
      "id": 12,
      "name": "The Palladium",
      "address": "Cincinnati, OH, US",
      "capacity": 100,
      "city": "Houston, TX, US",
      "description": "Featuring Magnifi",
      "lat": "29.7631",
      "lng": "-95.3631",
      "slug": "palladium-radio",
      "twitter_username": "@brooklynbowl",
      "website_url": "http://www.socialhallsf.com/"
    }
  ]
}

Response Parameters

  • shows: The list of shows

    • Required: yes
    • Type: array
    • Items

      • Required: yes
      • id: The id of the show
        • Required: yes
        • Type: integer
        • Example: 81
      • venue_id: The id of the venue
        • Required: yes
        • Type: integer
        • Example: 12
      • artist_id: The id of the artist
        • Required: yes
        • Type: integer
        • Example: 1
      • show_time: The date and time of the show, in UTC.
        • Required: yes
        • Type: string
        • Example: 2014-01-09 21:00:04 UTC
      • ticket_url: A link to buy tickets to this show
        • Required: no
        • Type: string
        • Example: http://ticketschmaster.com/show123/buy
  • venues: A lookup array of venues represented in the shows above.

    • Required: yes
    • Type: array
    • Items

      • Required: yes
      • id: The id of the venue
        • Required: yes
        • Type: integer
        • Example: 12
      • name: The name of the venue
        • Required: yes
        • Type: string
        • Example: The Palladium
      • address: Street address of venue
        • Required: no
        • Type:
          • null
          • string
        • Example: Cincinnati, OH, US
      • capacity: Capacity of venue
        • Required: yes
        • Type: integer
        • Example: 100
      • city: The city of the venue
        • Required: yes
        • Type: string
        • Example: Houston, TX, US
      • description: description of venue
        • Required: no
        • Type:
          • null
          • string
        • Example: Featuring Magnifi
      • lat: The latitude of the venue
        • Required: yes
        • Type: string
        • Example: 29.7631
      • lng: The longitude of the venue
        • Required: yes
        • Type: string
        • Example: -95.3631
      • slug: The unique slug for a venue.
        • Required: no
        • Type:
          • null
          • string
        • Example: palladium-radio
      • twitter_username: Twitter handle name of the venue
        • Required: no
        • Type:
          • null
          • string
        • Example: @brooklynbowl
      • website_url: Venue's website URL, to fallback to if ticket-url is unavailable
        • Required: no
        • Type:
          • null
          • string
        • Example: http://www.socialhallsf.com/

Response Codes

Successful Response Codes

  • 200: A successful response.

Failure Response Codes

  • 404: The artist was not found.