Docs
Bookings

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/api/v1/bookings

Read-only: bookings are created by visitors in the widget.

Query parameters

Prop

Type

Response 200

Returns a data array with a pagination object. Each item:

Prop

Type

Errors

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

Every error shares one envelope.

Example

curl https://www.hey.support/api/v1/bookings \
  -H 'Authorization: Bearer hs_live_…'

Get a lead

Returns one captured lead by its sqid-encoded id.

List knowledge sources for a chatbot

Returns what one chatbot has been trained on — crawled pages, uploaded files, text snippets, and Q&A pairs — with the number of indexed chunks each contributed.

On this page

Query parameters
Response 200
Errors
Example