Skip to main content
GET
List bookings

Authorizations

Authorization
string
header
required

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

Kallabot-Version
enum<string>

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.

Available options:
2026-11-07
Example:

"2026-11-07"

Query Parameters

from
string<date-time> | null

Window start; default 30 days before to.

to
string<date-time> | null

Window end; default now.

channel
string | null

Only bookings on this channel.

Maximum string length: 16
agent_id
string | null
Maximum string length: 64
limit
integer | null
Required range: 1 <= x <= 100
cursor
string | null
Maximum string length: 512

Response

Successful Response

data
Booking · object[]
required

The items on this page, in the list's order.

has_more
boolean
required

True when another page follows this one.

counts
Counts · object
required

{tool, analysis} totals in the window.

next_cursor
string | null

Pass as cursor to get the next page. Null on the last page. Opaque: don't parse it.

from
string | null

The window's start.

to
string | null

The window's end.