Events

List and retrieve events

A ticketed event with its dates. Its tickets are their own list.

The event object

The same for every key, live or test: there is no test copy of it.

idstringrequired

A event id, evt_ and 22 characters.

object"event"required

namestringrequired

slugstringrequired

descriptionstringrequirednullable

statusstringrequirednullable

venuestringrequirednullable

A venue id, ven_ and 22 characters.

price_per_ticketintegerrequirednullable

An amount in whole cents.

max_ticketsintegerrequirednullable

min_ticketsintegerrequirednullable

min_ageintegerrequirednullable

duration_minutesintegerrequirednullable

date_modestringrequirednullable

How its dates work: one date, several, or a series.

timezonestringrequirednullable

staff_onlybooleanrequired

datesarray of objectsrequired

dates[].idstringrequired

A event date id, evd_ and 22 characters.

dates[].labelstringrequirednullable

dates[].scheduled_atstringrequirednullable

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

dates[].local_datestringrequirednullable

The venue's own calendar day, yyyy-MM-dd.

dates[].local_timestringrequirednullable

The venue's own clock time, HH:mm, 24-hour.

dates[].duration_minutesintegerrequirednullable

dates[].max_ticketsintegerrequirednullable

dates[].price_per_ticketintegerrequirednullable

An amount in whole cents.

dates[].statusstringrequirednullable

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 event object

{
  "id": "evt_0TMXp8QPR6yGvKuV2GZQ10",
  "object": "event",
  "name": "<string>",
  "slug": "<string>",
  "description": "<string>",
  "status": "<string>",
  "venue": "ven_0TMXp8QPR6yGvKuV2GZQ10",
  "price_per_ticket": 4500,
  "max_tickets": 1,
  "min_tickets": 1,
  "min_age": 1,
  "duration_minutes": 1,
  "date_mode": "<string>",
  "timezone": "Australia/Sydney",
  "staff_only": true,
  "dates": [
    {
      "id": "evd_0TMXp8QPR6yGvKuV2GZQ10",
      "label": "<string>",
      "scheduled_at": "2026-10-08T03:00:00.000Z",
      "local_date": "2026-10-08",
      "local_time": "14:30",
      "duration_minutes": 1,
      "max_tickets": 1,
      "price_per_ticket": 4500,
      "status": "<string>"
    }
  ],
  "created_at": "2026-10-08T03:00:00.000Z",
  "updated_at": "2026-10-08T03:00:00.000Z"
}

List events

GEThttps://api.hatcel.com/events

Any key

Every event 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.

curl "https://api.hatcel.com/events?limit=25" \
  -H "Authorization: Bearer $HATCEL_API_KEY" \
  -H "Hatcel-Version: 2026-10-08"

200 response

{
  "object": "list",
  "data": [
    {
      "id": "evt_0TMXp8QPR6yGvKuV2GZQ10",
      "object": "event",
      "name": "<string>",
      "slug": "<string>",
      "description": "<string>",
      "status": "<string>",
      "venue": "ven_0TMXp8QPR6yGvKuV2GZQ10",
      "price_per_ticket": 4500,
      "max_tickets": 1,
      "min_tickets": 1,
      "min_age": 1,
      "duration_minutes": 1,
      "date_mode": "<string>",
      "timezone": "Australia/Sydney",
      "staff_only": true,
      "dates": [
        {
          "id": "evd_0TMXp8QPR6yGvKuV2GZQ10",
          "label": "<string>",
          "scheduled_at": "2026-10-08T03:00:00.000Z",
          "local_date": "2026-10-08",
          "local_time": "14:30",
          "duration_minutes": 1,
          "max_tickets": 1,
          "price_per_ticket": 4500,
          "status": "<string>"
        }
      ],
      "created_at": "2026-10-08T03:00:00.000Z",
      "updated_at": "2026-10-08T03:00:00.000Z"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJ0IjoiMjAyNi0xMC0wOFQwMzowMDowMC4wMDBaIiwiaSI6IjBmOGZhZDViIn0"
}

Retrieve a event

GEThttps://api.hatcel.com/events/{id}

Any key

One event 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 event's id, evt_ and 22 characters.

curl "https://api.hatcel.com/events/evt_0TMXp8QPR6yGvKuV2GZQ10" \
  -H "Authorization: Bearer $HATCEL_API_KEY" \
  -H "Hatcel-Version: 2026-10-08"

200 response

{
  "id": "evt_0TMXp8QPR6yGvKuV2GZQ10",
  "object": "event",
  "name": "<string>",
  "slug": "<string>",
  "description": "<string>",
  "status": "<string>",
  "venue": "ven_0TMXp8QPR6yGvKuV2GZQ10",
  "price_per_ticket": 4500,
  "max_tickets": 1,
  "min_tickets": 1,
  "min_age": 1,
  "duration_minutes": 1,
  "date_mode": "<string>",
  "timezone": "Australia/Sydney",
  "staff_only": true,
  "dates": [
    {
      "id": "evd_0TMXp8QPR6yGvKuV2GZQ10",
      "label": "<string>",
      "scheduled_at": "2026-10-08T03:00:00.000Z",
      "local_date": "2026-10-08",
      "local_time": "14:30",
      "duration_minutes": 1,
      "max_tickets": 1,
      "price_per_ticket": 4500,
      "status": "<string>"
    }
  ],
  "created_at": "2026-10-08T03:00:00.000Z",
  "updated_at": "2026-10-08T03:00:00.000Z"
}

Packages Tickets