Calls

Get all conversation logs

View as Markdown
Retrieve paginated conversation logs with support for various filters. Returns call logs for agents belonging to the authenticated user's organization.

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Query parameters

pageintegerOptional>=1Defaults to 1
Page number for pagination
limitintegerOptional1-500Defaults to 5

Number of items per page. Server-side cap is 500 — values above 500 are silently clamped.

agentIdsstringOptional

Comma-separated list of agent IDs to filter by

campaignIdsstringOptional

Comma-separated list of campaign IDs to filter by

callTypesenumOptional

Comma-separated list of call types to filter by

Allowed values:
searchstringOptional
Search query to filter by callId, fromNumber, or toNumber
statusFilterstringOptional

Comma-separated list of call statuses to filter by. Available statuses: pending, in_progress, in_queue, processing, active, completed, failed, no_answer, cancelled

disconnectReasonFilterstringOptional

Comma-separated list of disconnect reasons to filter by. Available reasons: user_hangup, agent_hangup, connection_error, timeout, system_error, transfer_complete

callAttemptFilterstringOptional

Comma-separated list of call attempt types to filter by. Available filters: initial (first attempt calls), retry (retry attempt calls), all (all calls)

durationFilterstringOptional

Comma-separated list of duration ranges to filter by. Available ranges: 0-30 (0-30 seconds), 30-60 (30-60 seconds), 1-5 (1-5 minutes), 5+ (more than 5 minutes)

sortByenumOptional
Field to sort results by
Allowed values:
sortOrderenumOptional
Sort direction
Allowed values:
dateFromdatetimeOptional

ISO date — return calls created on or after this date

dateTodatetimeOptional

ISO date — return calls created on or before this date

versionFilterstringOptional

Comma-separated version IDs to filter calls by the agent version that handled them

Response

Successful response
statusboolean
dataobject

Errors

400
Bad Request Error
Invalid input
statusboolean
errorslist of strings
401
Unauthorized Error
500
Internal Server Error