Skip to main content
DashboardVersion: v3

List Call Logs

GET/voice-ai/dashboard/call-logs

Returns call logs for Voice AI agents scoped to a location. Supports filtering by agent, contact, call type, action types, and date range (interpreted in the provided IANA timezone). Also supports sorting and 1-based pagination.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:voice-ai-dashboard.readonly
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3

Query Parameters

locationIdstringrequired

Location identifier. Filters results to this location.

agentIdstring

Agent identifier. When provided, returns logs for this agent only.

Example:507f1f77bcf86cd799439011
contactIdstring

Contact IDs (comma-separated) to filter by.

Example:contact123,contact456
callTypestring

Call type filter.

Available optionsLIVETRIAL
startDatenumber

Start date filter (Unix timestamp). Must be less than endDate. Both startDate and endDate must be provided together.

Example:1679308800000
endDatenumber

End date filter (Unix timestamp). Must be greater than startDate. Both startDate and endDate must be provided together.

Example:1679395199000
actionTypestring

Action type filter for call logs (comma-separated ACTION_TYPE values)

Available optionsCALL_TRANSFERDATA_EXTRACTIONIN_CALL_DATA_EXTRACTIONWORKFLOW_TRIGGERSMSAPPOINTMENT_BOOKINGCUSTOM_ACTIONKNOWLEDGE_BASE
Example:SMS,CALL_TRANSFER,WORKFLOW_TRIGGER
sortBystring

Field to sort by. Defaults to newest if omitted.

Available optionsdurationcreatedAt
sortstring

Sort direction. Applies only when sortBy is provided.

Available optionsascenddescend
pagenumber

Page number (1-based).

Default:1
pageSizenumber

Page size (max 50).

Default:10

Response

application/json

Successfully retrieved call logs

totalnumberrequired

Total number of items

Example:150
pagenumberrequired

Page number starting from 1

Example:2
pageSizenumberrequired

Number of items per page

Example:10
callLogsobject[]required

Array of call logs