Returns the tables, appointments and requests your agent took, newest start first — the same object every `reservation.*` webhook carries.
/api/v1/reservationsWindow on the start time with from/to (a day’s service, a week’s load), poll on since (creation time), and name the statuses you want with status; holds and blocked time are returned only when named. Read-only: reservations are made by visitors or by the team from the calendar.
Query parameters
Prop
Type
Response 200
Returns a data array with a pagination object. Each item:
Prop
Type
Errors
400— Unknown status or an invalid window401— Missing or invalid API key404— Chatbot not found429— Rate limit exceeded
Every error shares one envelope.
Example
curl https://www.hey.support/api/v1/reservations \
-H 'Authorization: Bearer hs_live_…'List bookings
Returns meetings booked through the agent, paginated — both natively scheduled meetings on your connected Google Calendar and Cal.com bookings, each carrying its provider, start and end time, attendee timezone, and status.
Get a reservation
Returns one reservation by its UUID — the id a webhook or the list named.