Basic Usage
Returns a paginated list of all events based on the account key entered into the URL. The events are returned in ascending order based on the event's start date.
GET https://api.bigtickets.com/v1/account/{account-key}/events
GET https://api.bigtickets.com/v1/account/{account-key}/events?expand=tickets
GET https://api.bigtickets.com/v1/account/{account-key}/events?filter=Atlanta
GET https://api.bigtickets.com/v1/account/{account-key}/events?start=2025-01-01&end=2025-12-31
GET https://api.bigtickets.com/v1/account/{account-key}/events?expand=tickets&filter=Atlanta&start=2025-01-01&end=2025-12-31
Query parameters limit and start_on_page can also be used as defined in Pagination.
An Example
curl https://api.bigtickets.com/v1/account/V0xiVnZZY2cwMHZqTlluMVVHVVBCQT09/events -u aSecretKey:
{
"next_page_starts_on": 2,
"items": [
{
"id": "1",
"key": "THN1bS9ma1djZUJURldvcmxPdkdsdz09",
"name": "ATL Mocha Fest 2025",
"isPublished": true,
"isSeated": false,
"start": "2025-03-24T19:00:00",
"end": "",
"detailUrl": "https://www.bigtickets.com/events/atl-demo/mocha-2025/",
"purchaseUrl": "https://www.bigtickets.com/e/atl-demo/mocha-2025/",
"venue": "Outdoor Park",
"venueAddress1": "120 Outdoor Park Dr",
"venueAddress2": "",
"venueCity": "Atlanta",
"venueState": "GA",
"venueZip": "30030",
"tickets": [
{
"id": "1",
"key": "aXNSZHhkL0tMQWlsTnFoc0NGWUIrQT09",
"active": true,
"name": "General Admission",
"quantity": 5000,
"price": 40.00,
"entryDateTime": "",
"itemType": "Ticket",
"itemDesc": ""
},
{
"id": "2",
"key": "NHZTbnUvVEVjUUJsdVB1L3NqeHFKQT09",
"active": true,
"name": "VIP",
"quantity": 200,
"price": 60.00,
"entryDateTime": "2025-03-24T18:00:00",
"itemType": "Ticket",
"itemDesc": ""
}
]
},
{
"id": "2",
"key": "RitxQ0RqOXFBNyt3UUtTMzJoU2c1UT09",
"name": "Comedy Outdoors",
"isPublished": true,
"isSeated": true,
"start": "2025-09-15T19:00:00",
"end": "",
"detailUrl": "https://www.bigtickets.com/events/atl-demo/comedy-outdoors-2025/",
"purchaseUrl": "https://www.bigtickets.com/e/atl-demo/comedy-outdoors-2025/",
"venue": "Outdoor Park",
"venueAddress1": "120 Outdoor Park Dr",
"venueAddress2": "",
"venueCity": "Atlanta",
"venueState": "GA",
"venueZip": "30030",
"tickets": [
{
"id": "3",
"key": "dzZDSk5acVAzSnF2UjFlcjNIR0ZOUT09",
"active": true,
"name": "General Admission",
"quantity": 500,
"price": 10.00,
"entryDateTime": "",
"itemType": "Seat",
"itemDesc": "",
"isGA": false,
"isBooth": false,
"section": "Floor"
}
]
}
]
}
-
start/end: Based on the timezone set in the account expressed as a data and time in ISO 8601 format
{YYYY-MM-DDTHH:mm:ss}. (i.e. with an account timezone of Eastern Time, 19:00:00 represents 7:00pm ET) -
isSeated: When
isSeatedistrue, additional ticket fieldsisGA,isBooth, andsectionwill be available.
Query Parameters
-
filter (optional)
Thefilterquery param is used to filter the events based on the event name (case insensitive). The filter value entered is treated as a wildcard search. -
expand (optional)
Theexpandquery param is a comma delimited list used to retrieve additional data. Currently the only value supported istickets. -
start (optional)
Thestartquery param is used to filter the data based on the event's start date. The value should be expressed as a date formatted in ISO 8601{YYYY-MM-DD}format. -
end (optional)
Theendquery param is used to filter the data based on the event's end date. The end date includes all the hours of that day. The value should be expressed as a date formatted in ISO 8601{YYYY-MM-DD}format.
Query parameters limit and start_on_page can also be used as defined in Pagination.