API Documentation
This page describes what information our APIs return, and how to retrieve it. To review the API Terms of Use and apply for a client API key, go to our Developer API page.
Please review whether the API returns all the information you require. For example, images are not provided.
Event Search API
Search for upcoming events. If no parameters are passed, then all the upcoming events will be returned. To improve response time, please use a combination of the parameters to retrieve only the desired events.
Parameters
Request Examples
Response Example
Note, start time and end time are only possible for live streams. It isn't possible to have an end time without having a start time.
b2bInd indicates whether that artist is performing back to back with the next artist in the list. Any number of artists may perform b2b e.g. 3 artists. The same artist may perform in multiple b2b's for the same event.
Nearby Events API
Find upcoming events that are nearby the provided latitude, longitude, and state. If the provided coordinates are not near a supported country, then all festivals and all live streams will be returned.
Parameters
Request Examples
Response Example
See the above response example for Event Search API.
Locations API
Retrieves information about the specified location. If the city/state parameters are not supplied, then all the popular locations will be returned (same locations that are used in Edmtrain's location dropdowns).
Parameters
Request Examples
Response Example
API Errors
If an error occurs, then the success attribute will be set to false. The message attribute will indicate the type of error.
Response Example
locations?state=fake&client=...