Skip to main content
GET
List Calls
call_analysis and call_outcome are deprecated and will be removed on 1st of February 2027. Both fields are retained for compatibility until then. Update your integrations to use outcomes before the removal date.

Call status mapping

Do not use call_status for new integrations. It is deprecated and returned only for backward compatibility. Use state, status, and follow_up instead.

Authorizations

Authorization
string
header
required

API key must be provided as: Bearer <api_key>

Query Parameters

contact_id
string<uuid>

Only return calls for this telli contact ID

agent_id
string<uuid>

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

limit
integer
default:50

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

Required range: 1 <= x <= 100
cursor
string

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

Response

Calls retrieved successfully

calls
object[]

Calls ordered by triggered_at descending

next_cursor
string | null

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