List Events
Search events with date, status, and inventory filters. Paginated.
/api/v1/events
Authentication
Pass your API key as an x-api-key header or ?apiKey=… query parameter. Your key must be subscribed to all required scopes below.
Required scopes
events:read
Request Body
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
| eventStartDate | body | string (YYYY-MM-DD) | No | Start of date range. Defaults to today. |
| eventEndDate | body | string (YYYY-MM-DD) | No | End of date range. Defaults to one year from start. |
| status | body | string | No | Filter by event status (e.g. "onsale", "offsale"). |
| sort | body | string | No | "date" or "status". |
| order | body | string | No | "asc" or "desc". |
| page | body | integer | No | Zero-indexed page number. |
| limit | body | integer | No | Results per page. Minimum 10. |
| onlyTmEvents | body | boolean | No | Only include events with a Ticketmaster ID. |
| vividStrict | body | boolean | No | Only include events with a Vivid Seats ID. |
| excludePastEvents | body | boolean | No | Exclude events that have already started. |
| tmStrict | body | boolean | No | Only include events with updated seat inventory. |
| maxInventory | body | integer | No | Maximum available seats. Requires tmStrict. |
Example Request
curl -X POST "https://kage-app-QwnFlwdLxKnfuQ-tm-events-api.kageserver.app/api/v1/events/" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"filters": {
"eventStartDate": "2025-06-01",
"eventEndDate": "2025-12-31",
"status": "onsale",
"sort": "date",
"order": "desc",
"page": 0,
"limit": 25,
"excludePastEvents": true
}
}'Example Response
{
"data": {
"events": [
{
"tm_id": "abc123",
"name": "Event Name",
"start_time": "2025-07-01T20:00:00Z",
"end_time": "2025-07-01T23:00:00Z",
"status": "onsale",
"url": "https://www.ticketmaster.com/...",
"image_url": "https://...",
"currency": "USD",
"category": "Music",
"genre": "Rock",
"venue": {
"name": "Madison Square Garden",
"capacity": 20000,
"street": "4 Pennsylvania Plaza",
"city": "New York",
"state": "NY",
"country": "US"
},
"price": {
"min_price": 49.99,
"max_price": 299.99,
"currency": "USD"
},
"sales": {
"public": {
"start_date_time": "2025-05-01T10:00:00Z",
"end_date_time": "2025-07-01T18:00:00Z",
"start_tbd": false
},
"presales": [
{
"name": "Artist Presale",
"description": "Exclusive artist presale",
"start_date_time": "2025-04-28T10:00:00Z",
"end_date_time": "2025-04-30T22:00:00Z",
"url": "https://...",
"visible": true
}
]
},
"attraction": {
"name": "Artist Name",
"type": "Music",
"upcoming_events": 15,
"url": "https://...",
"seo_name": "artist-name"
}
}
]
},
"total": 1500,
"count": 25,
"page": 0,
"total_pages": 60,
"pages_remaining": 59,
"limit": 25
}