Docs
Reservations

Get a reservation

Returns one reservation by its UUID — the id a webhook or the list named.

GET/api/v1/reservations/{id}

Responds 404 rather than 403 when the reservation belongs to another workspace, so ids cannot be enumerated.

Path parameters

Prop

Type

Response 200

Prop

Type

Errors

  • 401 — Missing or invalid API key
  • 404 — Not found
  • 429 — Rate limit exceeded

Every error shares one envelope.

Example

curl https://www.hey.support/api/v1/reservations/<id> \
  -H 'Authorization: Bearer hs_live_…'

List reservations

Returns the tables, appointments and requests your agent took, newest start first — the same object every `reservation.*` webhook carries.

List reservation services

Returns what one agent takes reservations for — its services, with the duration, party range, approval rule and the questions guests are asked — so a reservation’s `service_id` and `answers` can be read against them.

On this page

Path parameters
Response 200
Errors
Example