GET ​/api​/v3​/show​/:id

Returns detail of a show

Request

Example Request

{
  "key": "abcd12345"
}

Example Parameters

  • key: Api consumer key
    • Required: yes
    • Type: string
    • Example: abcd12345

Response

Example Response

{
  "show": {
    "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",
    "id": 81,
    "show_time": {
    },
    "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,
    "venue": {
      "id": 12,
      "address": "Cincinnati, OH, US",
      "name": "The Palladium",
      "capacity": 100,
      "city": "Houston, TX, US",
      "description": "Featuring Magnifi",
      "lat": "29.7631",
      "lng": "-95.3631",
      "slug": "palladium-radio",
      "twitter_username": "@brooklynbowl",
      "url": "http://www.socialhallsf.com/",
      "you_follow": true
    },
    "artist": {
      "id": 7680,
      "name": "Red Fang",
      "hometown": "Portland, OR, US",
      "slug": "rolling-stones",
      "genres": [
        "Rock"
      ],
      "tracks_count": {
      }
    }
  }
}

Response Parameters

  • show:

    • Required: no
    • followers_url: The url to retrieve the followers for this show
      • 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 artist of show
      • Required: no
      • Type:
        • null
        • string
      • Example: https://deliradio.com/api/v3/artists/followers?show_ids=399635,377239,384923&key=123
    • id: The id of the show
      • Required: yes
      • Type: integer
      • Example: 81
    • show_time: the time of the show
      • Required: no
      • Type: date-time
      • Example: 2013-12-10 11:30:00 -0800
    • 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
    • venue: Venue of show

      • Required: yes
      • id: The id of the venue
        • Required: yes
        • Type: integer
        • Example: 12
      • address: Street address of venue
        • Required: no
        • Type:
          • null
          • string
        • Example: Cincinnati, OH, US
      • name: The name of the venue
        • Required: yes
        • Type: string
        • Example: The Palladium
      • 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
      • url: Venue's website URL, to fallback to if ticket-url is unavailable
        • Required: no
        • Type:
          • null
          • string
        • Example: http://www.socialhallsf.com/
      • you_follow: Indicates if the current account has favorited/followed this venue.
        • Required: no
        • Type: boolean
        • Example: true
    • artist: Artist of show

      • Required: no
      • id: the id of the artist
        • Required: no
        • Type: integer
        • Example: 7680
      • name: the name of the artist
        • Required: no
        • Type: string
        • Example: Red Fang
      • hometown: the band's hometown city string
        • Required: no
        • Type: string
        • Example: Portland, OR, US
      • slug: The unique slug for an artist
        • Required: yes
        • Type: string
        • Example: rolling-stones
      • 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:

Failure Response Codes

  • 404: No show was found by given ID