List events
GET/api/v1/events
Published events, soonest first.
Permission
events:read (Read events)Publishable keyWorks with one, from your allowed web addresses
ListsPaged with limit and cursor. Pagination
Query parameters
whenstring- upcoming (default), past or all.
upcomingpastall expandstring- ticket_types to include each event's ticket types.
limitinteger- How many to return, 1 to 100. Default 25.
cursorstring- The next_cursor from the previous page.
curl "https://eos.aveoevents.com/api/v1/events?limit=10" \
-H "Authorization: Bearer $EOS_API_KEY"{
"object": "list",
"url": "/api/v1/events",
"has_more": false,
"next_cursor": null,
"data": [
{
"object": "event",
"id": 41,
"slug": "example-night",
"title": "Example Night",
"status": "on_sale",
"published": true,
"category": "music",
"starts_at": "2026-12-05T19:00:00.000Z",
"ends_at": "2026-12-05T23:30:00.000Z",
"timezone": "Europe/London",
"currency": "GBP",
"price_from": 26,
"summary": "An evening of live music.",
"description": "Doors at 7pm.\n\nOver 18s only.",
"venue": {
"name": "Example Hall",
"address": "1 Example Street, London"
},
"image_url": "https://eos.aveoevents.com/s/acme-events/uploads/hero.jpg",
"url": "https://eos.aveoevents.com/acme-events/events/example-night",
"gates": [
{
"id": "main",
"name": "Main entrance",
"allow": []
},
{
"id": "vip",
"name": "VIP door",
"allow": [
"vip",
"guest",
"artist",
"press",
"staff",
"crew",
"security"
]
}
],
"reentry": true
}
]
}Every field of the response: the event object.
Get an event
GET/api/v1/events/{id}
One event with its ticket types and live availability.
Permission
events:read (Read events)Publishable keyWorks with one, from your allowed web addresses
Path parameters
idintegerRequired- The event's id.
Errors it can give
- 404not_foundNo such object in this company.
curl "https://eos.aveoevents.com/api/v1/events/41" \
-H "Authorization: Bearer $EOS_API_KEY"{
"object": "event",
"id": 41,
"slug": "example-night",
"title": "Example Night",
"status": "on_sale",
"published": true,
"category": "music",
"starts_at": "2026-12-05T19:00:00.000Z",
"ends_at": "2026-12-05T23:30:00.000Z",
"timezone": "Europe/London",
"currency": "GBP",
"price_from": 26,
"summary": "An evening of live music.",
"description": "Doors at 7pm.\n\nOver 18s only.",
"venue": {
"name": "Example Hall",
"address": "1 Example Street, London"
},
"image_url": "https://eos.aveoevents.com/s/acme-events/uploads/hero.jpg",
"url": "https://eos.aveoevents.com/acme-events/events/example-night",
"gates": [
{
"id": "main",
"name": "Main entrance",
"allow": []
},
{
"id": "vip",
"name": "VIP door",
"allow": [
"vip",
"guest",
"artist",
"press",
"staff",
"crew",
"security"
]
}
],
"reentry": true,
"ticket_types": [
{
"object": "ticket_type",
"id": 9001,
"product_id": 812,
"event_id": 41,
"name": "General admission",
"description": "Entry from 7pm.",
"price": 25,
"booking_fee": 1,
"price_with_booking_fee": 26,
"booking_fee_payer": "buyer",
"paid_at_door": false,
"door_price": null,
"currency": "GBP",
"on_sale": true,
"sold_out": false,
"min_per_order": 1,
"max_per_order": 10,
"remaining": 180,
"note": null
}
]
}Every field of the response: the event object.
List ticket types
GET/api/v1/events/{id}/ticket-types
The event's ticket types on sale or coming up, with what is left.
Permission
events:read (Read events)Publishable keyWorks with one, from your allowed web addresses
Path parameters
idintegerRequired- The event's id.
Errors it can give
- 404not_foundNo such object in this company.
curl "https://eos.aveoevents.com/api/v1/events/41/ticket-types" \
-H "Authorization: Bearer $EOS_API_KEY"{
"object": "list",
"url": "/api/v1/events/41/ticket-types",
"has_more": false,
"next_cursor": null,
"data": [
{
"object": "ticket_type",
"id": 9001,
"product_id": 812,
"event_id": 41,
"name": "General admission",
"description": "Entry from 7pm.",
"price": 25,
"booking_fee": 1,
"price_with_booking_fee": 26,
"booking_fee_payer": "buyer",
"paid_at_door": false,
"door_price": null,
"currency": "GBP",
"on_sale": true,
"sold_out": false,
"min_per_order": 1,
"max_per_order": 10,
"remaining": 180,
"note": null
}
]
}Every field of the response: the ticket type object.
Publish an event
POST/api/v1/events/{id}/publish
Shows the event in the shop and puts its tickets on sale.
Permission
events:write (Publish events)Publishable keyNo: secret keys only
Idempotency-KeyAccepted. How retries stay safe
Path parameters
idintegerRequired- The event's id.
Errors it can give
- 404not_foundNo such object in this company.
- 409event_cancelledA cancelled event cannot be put on sale.
curl -X POST "https://eos.aveoevents.com/api/v1/events/41/publish" \
-H "Authorization: Bearer $EOS_API_KEY" \
-H "Idempotency-Key: $(uuidgen)"{
"object": "event",
"id": 41,
"slug": "example-night",
"title": "Example Night",
"status": "on_sale",
"published": true,
"category": "music",
"starts_at": "2026-12-05T19:00:00.000Z",
"ends_at": "2026-12-05T23:30:00.000Z",
"timezone": "Europe/London",
"currency": "GBP",
"price_from": 26,
"summary": "An evening of live music.",
"description": "Doors at 7pm.\n\nOver 18s only.",
"venue": {
"name": "Example Hall",
"address": "1 Example Street, London"
},
"image_url": "https://eos.aveoevents.com/s/acme-events/uploads/hero.jpg",
"url": "https://eos.aveoevents.com/acme-events/events/example-night",
"gates": [
{
"id": "main",
"name": "Main entrance",
"allow": []
},
{
"id": "vip",
"name": "VIP door",
"allow": [
"vip",
"guest",
"artist",
"press",
"staff",
"crew",
"security"
]
}
],
"reentry": true
}Every field of the response: the event object.
Unpublish an event
POST/api/v1/events/{id}/unpublish
Takes the event out of the shop. Orders already placed stay valid.
Permission
events:write (Publish events)Publishable keyNo: secret keys only
Idempotency-KeyAccepted. How retries stay safe
Path parameters
idintegerRequired- The event's id.
Errors it can give
- 404not_foundNo such object in this company.
curl -X POST "https://eos.aveoevents.com/api/v1/events/41/unpublish" \
-H "Authorization: Bearer $EOS_API_KEY" \
-H "Idempotency-Key: $(uuidgen)"{
"object": "event",
"id": 41,
"slug": "example-night",
"title": "Example Night",
"status": "on_sale",
"published": false,
"category": "music",
"starts_at": "2026-12-05T19:00:00.000Z",
"ends_at": "2026-12-05T23:30:00.000Z",
"timezone": "Europe/London",
"currency": "GBP",
"price_from": 26,
"summary": "An evening of live music.",
"description": "Doors at 7pm.\n\nOver 18s only.",
"venue": {
"name": "Example Hall",
"address": "1 Example Street, London"
},
"image_url": "https://eos.aveoevents.com/s/acme-events/uploads/hero.jpg",
"url": "https://eos.aveoevents.com/acme-events/events/example-night",
"gates": [
{
"id": "main",
"name": "Main entrance",
"allow": []
},
{
"id": "vip",
"name": "VIP door",
"allow": [
"vip",
"guest",
"artist",
"press",
"staff",
"crew",
"security"
]
}
],
"reentry": true
}Every field of the response: the event object.