API ReferenceCalls

List calls

Returns the account’s calls, newest first, with optional filters. Use status to narrow to live calls (for example in_progress), flowId / campaignId / contactId to scope by resource, and startDate / endDate for a time window.

Authentication

AuthorizationBearer

Pass a JWT access token or an API key (prefixed with tif_live_) as a Bearer token.

Query parameters

limitintegerOptional1-100Defaults to 20

Maximum number of items to return (default: 20, max: 100)

offsetintegerOptional>=0Defaults to 0

Number of items to skip for pagination (default: 0)

startDatedatetimeOptional

Only include calls after this timestamp (inclusive)

endDatedatetimeOptional

Only include calls before this timestamp (inclusive)

statusenumOptional
Filter by call status
directionenumOptional
Filter by call direction
Allowed values:
sourceenumOptional

Filter by call source (direct, scheduled, campaign)

Allowed values:
phoneNumberstringOptional

Filter by phone number — matches either the from or to number (E.164)

isLeadbooleanOptional

Filter by whether the call was triggered by a Meta lead form (true = lead-driven only)

flowIdstringOptionalformat: "uuid"
Filter by flow ID
contactIdstringOptionalformat: "uuid"
Filter by contact ID
scheduleIdstringOptionalformat: "uuid"

Filter by schedule ID (for scheduled calls)

campaignIdstringOptionalformat: "uuid"

Filter by campaign ID (for campaign calls)

providerTypeenumOptional

Filter by telephony provider type (channel)

Allowed values:
searchstringOptional

Free-text search across the contact name and the raw from/to phone numbers (case-insensitive substring). Matches calls to/from numbers that were never saved as contacts.

sortByenumOptional

Field to sort results by (default: creation time)

Allowed values:
sortDirectionenumOptional

Sort direction for sortBy (default: desc)

Allowed values:

Response

Paginated list of calls
callslist of objects
List of call records for the current page
metaobject
Pagination metadata

Errors

401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error
500
Internal Server Error