Skip to main content
GET
List calls

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

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

Only calls in these lifecycle states, comma-separated: requested, queued, dialing, ringing, connected, ending, completed, failed, canceled.

Pattern: ^(requested|queued|dialing|ringing|connected|ending|completed|failed|canceled)(,(requested|queued|dialing|ringing|connected|ending|completed|failed|canceled))*$
outcome
string | null

Only calls with these outcomes, comma-separated: answered, busy, no_answer, rejected, abandoned, provider_failed, runtime_failed, canceled, unknown.

Pattern: ^(answered|busy|no_answer|rejected|abandoned|provider_failed|runtime_failed|canceled|unknown)(,(answered|busy|no_answer|rejected|abandoned|provider_failed|runtime_failed|canceled|unknown))*$
agent_id
string | null
channel
enum<string> | null
Available options:
phone,
web
direction
enum<string> | null
Available options:
inbound,
outbound
attention
boolean | null
party
string | null
Maximum string length: 20
line
string | null
Pattern: ^[0-9a-fA-F-]{36}$
since
string | null
until
string | null
test_mode
boolean | null
disposition
string | null

Only calls the analysis filed under these, comma-separated: booked, interested, callback, lead_captured, resolved, not_interested, voicemail, wrong_number, no_answer, abandoned, failed, other.

Maximum string length: 200
Pattern: ^(booked|interested|callback|lead_captured|resolved|not_interested|voicemail|wrong_number|no_answer|abandoned|failed|other)(,(booked|interested|callback|lead_captured|resolved|not_interested|voicemail|wrong_number|no_answer|abandoned|failed|other))*$
sentiment
string | null

Only calls with this caller mood, comma-separated: positive, neutral, negative.

Maximum string length: 60
Pattern: ^(positive|neutral|negative)(,(positive|neutral|negative))*$
tags
string | null
Maximum string length: 500
has_recording
boolean | null
talk_ms_min
integer | null
Required range: x >= 0
talk_ms_max
integer | null
Required range: x >= 0
q
string | null
Required string length: 2 - 120
archived
enum<string>
default:false
Available options:
true,
false,
all

Response

Successful Response

A page of calls, newest first, with totals for the whole filter.

data
CallSummary · object[]
required

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

has_more
boolean
required

True when another page follows this one.

total
integer
required

Every call matching the filters, across all pages.

summary
CallListTotals · object
required

Totals for every call matching the filters.

next_cursor
string | null

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