Events

Your events with their dates, venue and ticket types, and live availability.

List events

GET/api/v1/events

Published events, soonest first.

Permissionevents: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.
Request
curl "https://eos.aveoevents.com/api/v1/events?limit=10" \
  -H "Authorization: Bearer $EOS_API_KEY"
200 response
{
  "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.

Permissionevents:read (Read events)
Publishable keyWorks with one, from your allowed web addresses

Path parameters

idintegerRequired
The event's id.

Errors it can give

Request
curl "https://eos.aveoevents.com/api/v1/events/41" \
  -H "Authorization: Bearer $EOS_API_KEY"
200 response
{
  "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.

Permissionevents:read (Read events)
Publishable keyWorks with one, from your allowed web addresses

Path parameters

idintegerRequired
The event's id.

Errors it can give

Request
curl "https://eos.aveoevents.com/api/v1/events/41/ticket-types" \
  -H "Authorization: Bearer $EOS_API_KEY"
200 response
{
  "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.

Permissionevents: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

Request
curl -X POST "https://eos.aveoevents.com/api/v1/events/41/publish" \
  -H "Authorization: Bearer $EOS_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
200 response
{
  "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.

Permissionevents: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

Request
curl -X POST "https://eos.aveoevents.com/api/v1/events/41/unpublish" \
  -H "Authorization: Bearer $EOS_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
200 response
{
  "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.