This version of the Bandsintown API will be deprecated in the coming months. Please contact us for more information.

Developer API

Responses

Artist - JSON

{
  "name": "Pete Rock",
  "url": "http://www.bandsintown.com/PeteRock",
  "mbid": "39a973f2-0785-4ef6-90d9-551378864f89",
  "upcoming_events_count": 7
}

Field Details:

Artist object
Name Description Data Type
name artist name String
url url to artist page on bandsintown.com String
mbid music brainz id or null if not available String or null
upcoming_events_count number of upcoming events Number

Requests

Artist - XML

<artist>
  <name>Pete Rock</name>
  <url>http://www.bandsintown.com/PeteRock</url>
  <mbid>39a973f2-0785-4ef6-90d9-551378864f89</mbid>
  <upcoming_events_count>7</upcoming_events_count>
</artist>

Field Details:

artist element
Name Description Data Type
name artist name string
url url to artist page on bandsintown.com string
mbid music brainz id or empty if unavailable string or empty
upcoming_events_count number of upcoming events int

Requests

Event - JSON

{
  "id": 745095,
  "url": "http://www.bandsintown.com/event/745095",
  "datetime": "2008-09-30T19:30:00",
  "ticket_url": "http://www.bandsintown.com/event/745095/buy_tickets",
  "artists": [{
    "name": "Little Brother",
    "url": "http://www.bandsintown.com/LittleBrother",
    "mbid": "b929c0c9-5de0-4d87-8eb9-365ad1725629"
  },{
    "name": "Chaundon",
    "url": "http://www.bandsintown.com/Chaundon",
    "mbid": "089b6424-3f04-4779-9da0-216e9b24c40b"
  }],
  "venue": {
    "id": 327987,
    "url": "http://www.bandsintown.com/venue/327987", 
    "region": "MA", 
    "city": "Boston", 
    "name": "Paradise Rock Club", 
    "country": "United States",
    "latitude": 42.37,
    "longitude" : 71.03
  },
  "status": "new",
  "ticket_status": "available",
  "on_sale_datetime": "2008-09-30T19:30:00" 
}

Field Details:

Event object (base object)
Name Description Data Type
id bandsintown.com event id Number
url url to event page on bandsintown.com String
datetime datetime of the event expressed in ISO 8601 format with no timezone.
YYYY-MM-DDThh:mm:ss 		String
ticket_url url to bandsintown.com framed ticket seller page String
artists array of artists performing at the event Array of artist Objects
venue venue object Object
status event status (this is only available in the daily event feed)
possible values: new, updated, deleted 		String
ticket_status tickets available/unavailable for the event String
on_sale_datetime on sale datetime for event tickets expressed in ISO 8601 format with no timezone, or null if unknown. String or null
Artist object
Name Description Data Type
name artist name String
url url to artist page on bandsintown.com String
mbid music brainz id or null if not available String or null
Venue object
Name Description Data Type
id bandsintown.com venue id Number
url url to venue page on bandsintown.com String
name venue name String
city venue city name String
region venue region name String
country venue country name String
latitude venue latitude Number
longitude venue longitude Number

Requests

Event - XML

<event>
  <id>745095</id>
  <url>http://www.bandsintown.com/event/745095</url>
  <datetime>2008-09-30T19:30:00</datetime>
  <ticket_url>http://www.bandsintown.com/event/745095/buy_tickets</ticket_url>
  <artists>
    <artist>
      <name>Little Brother</name>
      <url>http://www.bandsintown.com/LittleBrother</url>
      <mbid>b929c0c9-5de0-4d87-8eb9-365ad1725629</mbid>
    </artist>
    <artist>
      <name>Chaundon</name>
      <url>http://www.bandsintown.com/Chaundon</url>
      <mbid>089b6424-3f04-4779-9da0-216e9b24c40b</mbid>
    </artist>
  </artists>
  <venue>
    <id>314893</id>
    <url>http://www.bandsintown.com/venue/314893</url>
    <name>Fox Theatre Boulder</name>
    <city>Boulder</city>
    <region>CO</region>
    <country>United States</country>
    <latitude>42.37</latitude>
    <longitude>71.03</longitude>
  </venue>
  <status>new</status>
  <ticket_status>available</ticket_status>
  <on_sale_datetime>2008-09-30T19:30:00</on_sale_datetime>
</event>

Field Details:

event element
Name Description Data Type
id bandsintown.com event id int
url url to event page on bandsintown.com string
datetime datetime of the event expressed in ISO 8601 format with no timezone.
YYYY-MM-DDThh:mm:ss 		dateTime
ticket_url url to bandsintown.com framed ticket seller page string
artists container element of artists performing at this event n/a
venue venue container element n/a
status event status (this is only available in the daily event feed)
possible values: new, updated, deleted 		string
ticket_url url to bandsintown.com framed ticket seller page String
ticket_status tickets available/unavailable for the event String
on_sale_datetime on sale datetime for event tickets expressed in ISO 8601 format with no timezone, or empty if unknown. dateTime or empty
artist element
Name Description Data Type
name artist name string
url url to artist page on bandsintown.com string
mbid music brainz id or empty if unavailable string or empty
venue element
Name Description Data Type
id bandsintown.com venue id int
name venue name string
url url to venue page on bandsintown.com string
city venue city name string
region venue region name string
country venue country name string
latitude venue latitude float
latitude venue latitude float

Requests

Events - JSON

[{
  "id": 745095,
  "url": "http://www.bandsintown.com/event/745095",
  "datetime": "2008-09-30T19:30:00",
  "ticket_url": "http://www.bandsintown.com/event/745095/buy_tickets",
  "artists": [{
    "name": "Little Brother",
    "url": "http://www.bandsintown.com/LittleBrother",
    "mbid": "b929c0c9-5de0-4d87-8eb9-365ad1725629"
  },{
    "name": "Chaundon",
    "url": "http://www.bandsintown.com/Chaundon",
    "mbid": "089b6424-3f04-4779-9da0-216e9b24c40b"
  }],
  "venue": {
    "id": 327987,
    "url": "http://www.bandsintown.com/venue/327987", 
    "region": "MA", 
    "city": "Boston", 
    "name": "Paradise Rock Club", 
    "country": "United States",
    "latitude": 42.37,
    "longitude" : 71.03
  },
  "status": "new",
  "ticket_status": "available",
  "on_sale_datetime": "2008-09-30T19:30:00" 
}]

Field Details:

The response is an array of Event objects. See Event - JSON for field details.

Requests

Events - XML

<events>
  <event>
    <id>745095</id>
    <url>http://www.bandsintown.com/event/745095</url>
    <datetime>2008-09-30T19:30:00</datetime>
    <ticket_url>http://www.bandsintown.com/event/745095/buy_tickets</ticket_url>
    <artists>
      <artist>
        <name>Little Brother</name>
        <url>http://www.bandsintown.com/LittleBrother</url>
        <mbid>b929c0c9-5de0-4d87-8eb9-365ad1725629</mbid>
      </artist>
      <artist>
        <name>Chaundon</name>
        <url>http://www.bandsintown.com/Chaundon</url>
        <mbid>089b6424-3f04-4779-9da0-216e9b24c40b</mbid>
      </artist>
    </artists>
    <venue>
      <id>314893</id>
      <url>http://www.bandsintown.com/venue/314893</url>
      <name>Fox Theatre Boulder</name>
      <city>Boulder</city>
      <region>CO</region>
      <country>United States</country>
      <latitude>42.37</latitude>
      <longitude>71.03</longitude>
    </venue>
    <status>new</status>
    <ticket_status>available</ticket_status>
    <on_sale_datetime>2008-09-30T19:30:00</on_sale_datetime>
  </event>
</events>

Field Details:

The response is a list of event elements. See Event - XML for field details.

Requests

Venues - JSON

[{
  "id": 1700,
  "url": "http://www.bandsintown.com/venue/1700", 
  "name": "Paradise Rock Club", 
  "city": "Boston", 
  "region": "MA", 
  "country": "United States",
  "latitude": 42.37,
  "longitude" : 71.03
}]

Field Details:

Venue object (base array elements)
Name Description Data Type
id bandsintown.com venue id Number
url url to venue page on bandsintown.com String
name venue name String
city venue city name String
region venue region name String
country venue country name String
latitude venue latitude Number
longitude venue longitude Number

Requests

Venues - XML

<venues>
  <venue>
    <id>314893</id>
    <url>http://www.bandsintown.com/venue/314893</url>
    <name>Fox Theatre Boulder</name>
    <city>Boulder</city>
    <region>CO</region>
    <country>United States</country>
    <latitude>42.37</latitude>
    <longitude>71.03</longitude>
  </venue>
</venues>

Field Details:

venue element
Name Description Data Type
id bandsintown.com venue id int
name venue name string
url url to venue page on bandsintown.com string
city venue city name string
region venue region name string
country venue country name string
latitude venue latitude float
latitude venue latitude float

Requests

Success Message - JSON

 {
   message: "Event successfully submitted (Pending Approval)"
 }

Requests

Success Message - XML

<response>
  <message>Event successfully cancelled</message>
</response>

Requests

Errors - JSON

 {
   errors: [
     "Artist is a required field",
     "Location not found"
   ]
 }

Errors - XML

<error_response>
  <errors>
    <error>Artist is a required field</error>
    <error>Location not found</error>
  </errors>
</error_response>
Footer_press_cnet

© 2012 Bandsintown | All Rights Reserved