List bookings
Returns bookings agents made, from successful booking-tool runs and conversations marked booked, newest first. Filter by from and to (default: the last 30 days), channel and agent_id; limit up to 500.
Scopes: inbox:read
Authorizations
An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.
Headers
The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.
2026-11-07 "2026-11-07"
Query Parameters
Window start; default 30 days before to.
Window end; default now.
Only bookings on this channel.
16641 <= x <= 100512Response
Successful Response
The items on this page, in the list's order.
True when another page follows this one.
{tool, analysis} totals in the window.
Pass as cursor to get the next page. Null on the last page. Opaque: don't parse it.
The window's start.
The window's end.