List Calls

Returns a paginated list of calls for the authenticated account, ordered by triggered_at descending. Optionally filter by contact_id to return only calls for a single contact, or by agent_id to return only calls for a single agent. contact_id and agent_id cannot be used together. Each item is a lean call payload: the response does not include a separate top-level contact object, and the external_contact_id and contact_details fields are omitted from each call (unlike Get Call). Use the Contact endpoints if you need contact details.

get/v1/list-calls

Query parameters

contact_idstring uuid

Only return calls for this telli contact ID

agent_idstring uuid

Only return calls for this telli agent ID. Cannot be combined with contact_id.

limitinteger

Maximum number of calls to return (1-100, default 50)

cursorstring

Opaque cursor returned as next_cursor from a previous response. Pass unchanged to fetch the next page.

Response

Calls retrieved successfully

next_cursorstring nullable

Pass as cursor in the next request to fetch more results. null when there are no more pages.

Changes

No recorded changes to this endpoint across all 1 revision of this API.