Skip to contentSkip to navigation
Hatcel
Developers
2026-10-08API status

Tickets

List and retrieve tickets

One place at an event date, sold on an order.

The ticket object

Real records only, so a test key never sees one. See Test data.

idstringrequired

A ticket id, tkt_ and 22 characters.

object"ticket"required
eventstringrequirednullable

A event id, evt_ and 22 characters.

event_datestringrequirednullable

A event date id, evd_ and 22 characters.

orderstringrequirednullable

A order id, ord_ and 22 characters.

customerstringrequirednullable

A customer id, cus_ and 22 characters.

attendee_namestringrequirednullable
statusstringrequirednullable
checked_in_atstringrequirednullable

A UTC instant, ISO 8601, e.g. 2026-10-08T03:00:00.000Z.

created_atstringrequired

A UTC instant, ISO 8601, e.g. 2026-10-08T03:00:00.000Z.

updated_atstringrequired

A UTC instant, ISO 8601, e.g. 2026-10-08T03:00:00.000Z.

The ticket object
{
  "id": "tkt_0TMXp8QPR6yGvKuV2GZQ10",
  "object": "ticket",
  "event": "evt_0TMXp8QPR6yGvKuV2GZQ10",
  "event_date": "evd_0TMXp8QPR6yGvKuV2GZQ10",
  "order": "ord_0TMXp8QPR6yGvKuV2GZQ10",
  "customer": "cus_0TMXp8QPR6yGvKuV2GZQ10",
  "attendee_name": "<string>",
  "status": "<string>",
  "checked_in_at": "2026-10-08T03:00:00.000Z",
  "created_at": "2026-10-08T03:00:00.000Z",
  "updated_at": "2026-10-08T03:00:00.000Z"
}

List tickets

GEThttps://api.hatcel.com/tickets
Any key

Every ticket the key can see, newest first, a page at a time.

Query parameters

limitinteger

How many to return, 1 to 100. Defaults to 25.

starting_afterstring

The next_cursor of the page before. Omit it for the first page.

updated_sincestring

Only rows changed at or after this instant, ISO 8601 with an offset.

eventstring

Only those for this event, by its evt_ id.

customerstring

Only those for this customer, by its cus_ id.

orderstring

Only those for this order, by its ord_ id.

curl "https://api.hatcel.com/tickets?limit=25" \
  -H "Authorization: Bearer $HATCEL_API_KEY" \
  -H "Hatcel-Version: 2026-10-08"
200 response
{
  "object": "list",
  "data": [
    {
      "id": "tkt_0TMXp8QPR6yGvKuV2GZQ10",
      "object": "ticket",
      "event": "evt_0TMXp8QPR6yGvKuV2GZQ10",
      "event_date": "evd_0TMXp8QPR6yGvKuV2GZQ10",
      "order": "ord_0TMXp8QPR6yGvKuV2GZQ10",
      "customer": "cus_0TMXp8QPR6yGvKuV2GZQ10",
      "attendee_name": "<string>",
      "status": "<string>",
      "checked_in_at": "2026-10-08T03:00:00.000Z",
      "created_at": "2026-10-08T03:00:00.000Z",
      "updated_at": "2026-10-08T03:00:00.000Z"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJ0IjoiMjAyNi0xMC0wOFQwMzowMDowMC4wMDBaIiwiaSI6IjBmOGZhZDViIn0"
}

Retrieve a ticket

GEThttps://api.hatcel.com/tickets/{id}
Any key

One ticket by its id, with its version in the ETag header. Another object's id, or one this key cannot see, is a 404.

Path parameters

idstringrequired

The ticket's id, tkt_ and 22 characters.

curl "https://api.hatcel.com/tickets/tkt_0TMXp8QPR6yGvKuV2GZQ10" \
  -H "Authorization: Bearer $HATCEL_API_KEY" \
  -H "Hatcel-Version: 2026-10-08"
200 response
{
  "id": "tkt_0TMXp8QPR6yGvKuV2GZQ10",
  "object": "ticket",
  "event": "evt_0TMXp8QPR6yGvKuV2GZQ10",
  "event_date": "evd_0TMXp8QPR6yGvKuV2GZQ10",
  "order": "ord_0TMXp8QPR6yGvKuV2GZQ10",
  "customer": "cus_0TMXp8QPR6yGvKuV2GZQ10",
  "attendee_name": "<string>",
  "status": "<string>",
  "checked_in_at": "2026-10-08T03:00:00.000Z",
  "created_at": "2026-10-08T03:00:00.000Z",
  "updated_at": "2026-10-08T03:00:00.000Z"
}