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

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

Request

Example Request

{
  "genres": "Rock,Jazz,Reggae",
  "from_date": 20150820,
  "to_date": 20150820,
  "page": 1,
  "per_page": 50
}

Example Parameters

  • genres: Optional list of genres, comma separated, to filter the shows by.

    • Required: no
    • Type: string
    • Example: Rock,Jazz,Reggae
  • from_date: Date in format YYYYmmdd, to begin date range from

    • Required: no
    • Type: string
    • Example: 20150820
  • to_date: Date in format YYYYmmdd, to end date range at

    • Required: no
    • Type: string
    • Example: 20150820
  • page: The page number (starting at 1)

    • Required: no
    • Type: integer
    • Example: 1
  • per_page: The number of records returned in each page. Defaults to 50

    • Required: no
    • Type: integer
    • Example: 50

Response

Example Response

{
  "meta": {
    "page": 1,
    "total_pages": 10,
    "per_page": 20,
    "records": 200
  },
  "shows_meta": {
    "followers_url": "https://deliradio.com/api/v3/shows/followers?ids=399635,377239,384923&key=123",
    "artists_followers_url": "https://deliradio.com/api/v3/artists/followers?show_ids=399635,377239,384923&key=123"
  },
  "shows": [
    {
      "id": 81,
      "venue_id": 12,
      "artist_id": 1,
      "show_time": "2014-01-09 21:00:04 UTC",
      "ticket_url": "http://deliradio.com/go?bid=123&bn=The+Classic+Crime&url=http%3A%2F%2Fwww.bandsintown.com%2Fevent%2F7402810%2Fbuy_tickets%3Fartist%3DCrime",
      "photo_landscape_100": "https://deliradio-development.s3.amazonaws.com/uploads/picture/band/14278/68151/landscape_100_38bd769c-3d83-42ff-a66f-4e69ae71f18a.jpg",
      "photo_small_wide": "https://deliradio-development.s3.amazonaws.com/uploads/picture/band/14278/68151/small_wide_retina_100_38bd769c-3d83-42ff-a66f-4e69ae71f18a.jpg",
      "you_follow": true
    }
  ],
  "artists": [
    {
      "id": 1,
      "name": "Thee Oh Sees",
      "slug": "rolling-stones",
      "hometown": "San Francisco, CA, US",
      "genres": [
        "Rock"
      ],
      "tracks_count": {
      }
    }
  ]
}

Response Parameters

  • meta: Contains paging information about the response

    • Required: no
    • page: The page number (starting at 1)
      • Required: no
      • Type: integer
      • Example: 1
    • total_pages: The total number of pages you can request.
      • Required: no
      • Type: integer
      • Example: 10
    • per_page: The number of records returned in each page.
      • Required: no
      • Type: integer
      • Example: 20
    • records: The total number of records available.
      • Required: no
      • Type: integer
      • Example: 200
  • shows_meta: Contains additional information related to shows

    • Required: no
    • followers_url: The url to retrieve the followers for this list of shows.
      • Required: no
      • Type:
        • null
        • string
      • Example: https://deliradio.com/api/v3/shows/followers?ids=399635,377239,384923&key=123
    • artistsfollowersurl: The url to retrieve the followers for this list of artists.
      • Required: no
      • Type:
        • null
        • string
      • Example: https://deliradio.com/api/v3/artists/followers?show_ids=399635,377239,384923&key=123
  • shows: The list of shows

    • Required: yes
    • Type: array
    • Items

      • Required: no
      • 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: the url for tickets to the show
        • Required: no
        • Type: string
        • Example: http://deliradio.com/go?bid=123&bn=The+Classic+Crime&url=http%3A%2F%2Fwww.bandsintown.com%2Fevent%2F7402810%2Fbuy_tickets%3Fartist%3DCrime
      • photolandscape100: First photo URL of corresponding band. Returns 200x150 image if DELI-RETINA:"true" was included in HTTP header. Otherwise returns 100x75 version of the same image.
        • Required: no
        • Type: string
        • Example: https://deliradio-development.s3.amazonaws.com/uploads/picture/band/14278/68151/landscape10038bd769c-3d83-42ff-a66f-4e69ae71f18a.jpg
      • photosmallwide: Small wide photo. Returns 640x316 image if DELI-RETINA:"true" was included in HTTP header. Otherwise returns 320x158 version of the same image.
        • Required: no
        • Type: string
        • Example: https://deliradio-development.s3.amazonaws.com/uploads/picture/band/14278/68151/smallwideretina10038bd769c-3d83-42ff-a66f-4e69ae71f18a.jpg
      • you_follow: Indicates if the current account has favorited/followed the show.
        • Required: yes
        • Type: boolean
        • Example: true
  • artists: A lookup of artists represented in the shows above.

    • Required: no
    • Type: array
    • Items

      • Required: no
      • id: the id of the artist
        • Required: no
        • Type: integer
        • Example: 1
      • name: the name of the artist
        • Required: no
        • Type: string
        • Example: Thee Oh Sees
      • slug: The unique slug for an artist
        • Required: yes
        • Type: string
        • Example: rolling-stones
      • hometown: the band's hometown city string
        • Required: no
        • Type: string
        • Example: San Francisco, CA, US
      • genres: The list of genre's for this artist.

        • Required: no
        • Type: array
        • Example: [ "Rock", "Indie", "Blues" ]
        • Items

          • Required: no
          • Type: string
          • Example: Rock
      • tracks_count: Count of tracks this artist has

        • Required: no
        • Type: Number
        • Example: 1

Response Codes

Successful Response Codes

  • 200: A successful response.

Failure Response Codes

  • 404: The venue was not found.