Docs

Tickets

Last updated: 26 Oct 2026

A ticket is an event admission. This is the booking/visit view; for revenue, follow order_id to Orders.

Requires the tickets:read permission.

List tickets

GET /admin/v0/tickets?event_from=2026-07-01T00:00:00Z&event_to=2026-07-31T00:00:00Z
Authorization: Bearer YOUR_API_KEY

Returns tickets newest-first, in the paginated envelope. The date filters match on the event's start time.

Query parameters

ParameterTypeDescription
event_fromstringISO 8601 timestamp; events starting at/after this
event_tostringISO 8601 timestamp; events starting at/before this
updated_sincestringISO 8601 timestamp; for incremental sync
pageintegerPage index (default 1)
per_pageintegerItems per page (default 50, max 200)

Get a ticket

GET /admin/v0/tickets/{id}
Authorization: Bearer YOUR_API_KEY

Response

{
  "data": {
    "id": "c3d4…",
    "event_id": "9a8b…",
    "event_name": "Midsummer Concert",
    "event_starts_at": "2026-07-15T19:00:00+02:00",
    "event_ends_at": "2026-07-15T22:00:00+02:00",
    "variant_name": "General Admission",
    "status": "Issued",
    "order_id": "7eeecefd-…",
    "customer_id": "8f268b4a-…",
    "booked_at": "2026-06-01T10:15:00+02:00",
    "created_at": "2026-06-01T10:15:00+02:00",
    "updated_at": "2026-06-20T18:30:00+02:00",
    "cancelled_at": null
  }
}

Fields

FieldTypeNotes
idstringTicket public id
event_idstringPublic id of the event this ticket admits to
event_namestringEvent name
event_starts_atstringWhen the event starts (ISO 8601)
event_ends_atstringWhen the event ends (ISO 8601)
variant_namestringTicket type
statusstringDisplay label (see note below)
order_idstringThe order this ticket belongs to (revenue)
customer_idstringPseudonymous customer id (no PII)
booked_atstringWhen the customer booked
created_atstringWhen the ticket reached SERVOS
updated_atstringLast change to the ticket
cancelled_atstringWhen it was cancelled; null if not cancelled

status is a human-readable label — one of Issued, Checked-in, Cancelled, Refunded. It's for display, not logic: see Conventions → Status labels.