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

Venues

List and retrieve venues

A place the workspace trades from, with the timezone its times are read in.

The venue object

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

idstringrequired

A venue id, ven_ and 22 characters.

object"venue"required
namestringrequired
slugstringrequired
booking_codestringrequirednullable

The short code on this venue's booking numbers.

timezonestringrequired

IANA timezone every local time at this venue is read in.

currencystringrequirednullable

ISO 4217 currency code, lowercase, e.g. aud.

addressobjectrequired
address.line1stringrequirednullable
address.citystringrequirednullable
address.statestringrequirednullable
address.postal_codestringrequirednullable
address.countrystringrequirednullable
phonestringrequirednullable
emailstringrequirednullable
activebooleanrequired
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 venue object
{
  "id": "ven_0TMXp8QPR6yGvKuV2GZQ10",
  "object": "venue",
  "name": "<string>",
  "slug": "<string>",
  "booking_code": "<string>",
  "timezone": "Australia/Sydney",
  "currency": "aud",
  "address": {
    "line1": "<string>",
    "city": "<string>",
    "state": "<string>",
    "postal_code": "<string>",
    "country": "<string>"
  },
  "phone": "<string>",
  "email": "alex@example.com",
  "active": true,
  "created_at": "2026-10-08T03:00:00.000Z",
  "updated_at": "2026-10-08T03:00:00.000Z"
}

List venues

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

Every venue 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/venues?limit=25" \
  -H "Authorization: Bearer $HATCEL_API_KEY" \
  -H "Hatcel-Version: 2026-10-08"
200 response
{
  "object": "list",
  "data": [
    {
      "id": "ven_0TMXp8QPR6yGvKuV2GZQ10",
      "object": "venue",
      "name": "<string>",
      "slug": "<string>",
      "booking_code": "<string>",
      "timezone": "Australia/Sydney",
      "currency": "aud",
      "address": {
        "line1": "<string>",
        "city": "<string>",
        "state": "<string>",
        "postal_code": "<string>",
        "country": "<string>"
      },
      "phone": "<string>",
      "email": "alex@example.com",
      "active": true,
      "created_at": "2026-10-08T03:00:00.000Z",
      "updated_at": "2026-10-08T03:00:00.000Z"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJ0IjoiMjAyNi0xMC0wOFQwMzowMDowMC4wMDBaIiwiaSI6IjBmOGZhZDViIn0"
}

Retrieve a venue

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

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

curl "https://api.hatcel.com/venues/ven_0TMXp8QPR6yGvKuV2GZQ10" \
  -H "Authorization: Bearer $HATCEL_API_KEY" \
  -H "Hatcel-Version: 2026-10-08"
200 response
{
  "id": "ven_0TMXp8QPR6yGvKuV2GZQ10",
  "object": "venue",
  "name": "<string>",
  "slug": "<string>",
  "booking_code": "<string>",
  "timezone": "Australia/Sydney",
  "currency": "aud",
  "address": {
    "line1": "<string>",
    "city": "<string>",
    "state": "<string>",
    "postal_code": "<string>",
    "country": "<string>"
  },
  "phone": "<string>",
  "email": "alex@example.com",
  "active": true,
  "created_at": "2026-10-08T03:00:00.000Z",
  "updated_at": "2026-10-08T03:00:00.000Z"
}