GET ​/api​/v3​/account​/calendar

Gets a list of shows for artists and/or gigs favorited by the account and/or the accounts they follow near a location.

Request

Example Request

{
  "auth_token": "ef43987dc3dfca56255915d3b109714ecd4516ac54f527",
  "lat": 29.7628,
  "lng": -95.3831,
  "radius": 20,
  "genres": "Rock,Jazz,Reggae",
  "genres_excluded": "Country",
  "include_followed_accounts": true
}

Example Parameters

  • auth_token: The auth_token of the previously authenticated user. Retrieve this from the auth api.

    • Required: yes
    • Type: string
    • Example: ef43987dc3dfca56255915d3b109714ecd4516ac54f527
  • lat: Latitude

    • Required: yes
    • Type: number
    • Example: 29.7628
  • lng: Longitude

    • Required: yes
    • Type: number
    • Example: -95.3831
  • radius: The radius (in miles) to search for. Default is no limit. The response is paged.

    • Required: no
    • Type: integer
    • Example: 20
  • genres: Optional list of genres, comma separated, to filter the shows by.

    • Required: no
    • Type: string
    • Example: Rock,Jazz,Reggae
  • genres_excluded: Optional list of genres to exclude. This takes precedence over genres included.

    • Required: no
    • Type: string
    • Example: Country
  • includefollowedaccounts: Whether artists and/or gigs favorited by acccounts the current account follows should be included.

    • Required: no
    • Type: boolean
    • Example: true

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": 84211,
      "venue_id": 7680,
      "artist_id": 8570,
      "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
    }
  ],
  "venues": [
    {
      "id": 100754,
      "name": "EastDown Warehouse",
      "address": "Cincinnati, OH, US",
      "capacity": 100,
      "city": "Houston, TX, US",
      "description": "Featuring Magnifi",
      "lat": "29.7630556",
      "lng": "-95.3831",
      "slug": "palladium-radio",
      "twitter_username": "@brooklynbowl",
      "website_url": "http://www.socialhallsf.com/"
    }
  ],
  "artists": [
    {
      "id": 7680,
      "name": "Red Fang",
      "hometown": "Portland, OR, US",
      "slug": "red-fang",
      "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 in the current page.

    • Required: no
    • Type: array
    • Items

      • Required: no
      • id: the id of the show
        • Required: no
        • Type: integer
        • Example: 84211
      • venue_id: the id of the venue (more details available in the venue lookup)
        • Required: no
        • Type: integer
        • Example: 7680
      • artist_id: the id of the artist (more details available in the artist lookup)
        • Required: no
        • Type: integer
        • Example: 8570
      • 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
  • venues: A lookup of venues referenced in the shows collection

    • Required: no
    • Type: array
    • Items

      • Required: no
      • id: the id of the venue
        • Required: no
        • Type: integer
        • Example: 100754
      • name: the name of the venue
        • Required: no
        • Type: string
        • Example: EastDown Warehouse
      • 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 string of the venue
        • Required: no
        • 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: no
        • Type: string
        • Example: 29.7630556
      • lng: the longitude of the venue
        • Required: no
        • Type: string
        • Example: -95.3831
      • 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/
  • artists: A lookup of artists referenced in the shows collection

    • Required: no
    • Type: array
    • Items

      • 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: a human-readable url component that uniquely identifies the artist. Used in other API calls to fetch information about this artist.
        • Required: yes
        • Type: string
        • Example: red-fang
      • 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