List calls
Returns calls newest first, with filters such as agent_id, direction, lifecycle, outcome, since and until (ISO timestamps with a timezone), tags and has_recording. Archived calls are left out unless archived=true or all; searching what was said with q needs call:content. Page with limit (up to 100) and cursor; total and summary count every match.
Scopes: call: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
1 <= x <= 100512Only calls in these lifecycle states, comma-separated: requested, queued, dialing, ringing, connected, ending, completed, failed, canceled.
^(requested|queued|dialing|ringing|connected|ending|completed|failed|canceled)(,(requested|queued|dialing|ringing|connected|ending|completed|failed|canceled))*$Only calls with these outcomes, comma-separated: answered, busy, no_answer, rejected, abandoned, provider_failed, runtime_failed, canceled, unknown.
^(answered|busy|no_answer|rejected|abandoned|provider_failed|runtime_failed|canceled|unknown)(,(answered|busy|no_answer|rejected|abandoned|provider_failed|runtime_failed|canceled|unknown))*$phone, web inbound, outbound 20^[0-9a-fA-F-]{36}$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.
200^(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))*$Only calls with this caller mood, comma-separated: positive, neutral, negative.
60^(positive|neutral|negative)(,(positive|neutral|negative))*$500x >= 0x >= 02 - 120true, false, all Response
Successful Response
A page of calls, newest first, with totals for the whole filter.
The items on this page, in the list's order.
True when another page follows this one.
Every call matching the filters, across all pages.
Totals for every call matching the filters.
Pass as cursor to get the next page. Null on the last page. Opaque: don't parse it.