Returns call logs for Voice AI agents scoped to a account. Supports filtering by agent, contact, call type, action types, and date range (interpreted in the provided IANA timezone). Also supports sort
Returns call logs for Voice AI agents scoped to a account. 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.
http
GET https://services.leadconnectorhq.com/voice-ai/dashboard/call-logs
Authorization
Name
Type
Required
Example
Description
Authorization
string
Yes
Bearer token generated from the Leadway portal. See Authentication.
Version
string
Yes
2021-07-28
API version.
Query parameters
Name
Type
Required
Example
Description
locationId
string
Yes
Account identifier. Filters results to this account.
agentId
string
No
507f1f77bcf86cd799439011
Agent identifier. When provided, returns logs for this agent only.
contactId
string
No
contact123,contact456
Contact IDs (comma-separated) to filter by.
callType
string
No
Call type filter.
startDate
number
No
1679308800000
Start date filter (Unix timestamp). Must be less than endDate. Both startDate and endDate must be provided together.
endDate
number
No
1679395199000
End date filter (Unix timestamp). Must be greater than startDate. Both startDate and endDate must be provided together.
actionType
string
No
SMS,CALL_TRANSFER,WORKFLOW_TRIGGER
Action type filter for call logs (comma-separated ACTION_TYPE values)
sortBy
string
No
Field to sort by. Defaults to newest if omitted.
sort
string
No
Sort direction. Applies only when sortBy is provided.
page
number
No
Page number (1-based).
pageSize
number
No
Page size (max 50).
Responses
200 - Successfully retrieved call logs
total (number, required): Total number of items Example: 150
page (number, required): Page number starting from 1 Example: 2
pageSize (number, required): Number of items per page Example: 10
callLogs (object[], required): Array of call logs
id (string, required): Unique identifier for the call Example: 507f1f77bcf86cd799439011
contactId (string): Associated contact ID Example: 507f1f77bcf86cd799439012
agentId (string, required): Agent ID associated with the call Example: 507f1f77bcf86cd799439013
isAgentDeleted (boolean, required): Whether the agent is deleted Example: False
fromNumber (string): Caller phone number Example: +1234567890
createdAt (string, required): Timestamp when the call was created Example: 2024-01-15T10:30:00.000Z
duration (number, required): Call duration in seconds Example: 180
trialCall (boolean, required): Whether this call was a trial call Example: False
executedCallActions (object[], required): Actions performed during the call. Note: The APPOINTMENT_BOOKING action will only be visible in executedCallActions from Sep 9th 2025.
actionId (string): Action ID reference Example: 507f1f77bcf86cd799439015
actionType (string, required): Action type Possible values: 'CALL_TRANSFER', 'DATA_EXTRACTION', 'IN_CALL_DATA_EXTRACTION', 'WORKFLOW_TRIGGER', 'SMS', 'APPOINTMENT_BOOKING', 'CUSTOM_ACTION', 'KNOWLEDGE_BASE' Example: SMS
actionName (string, required): Action name Example: Send SMS Confirmation
actionParameters (object): Action parameters - structure varies by actionType
executedAt (string): When the action was executed Example: 2024-01-15T10:32:00.000Z
triggerReceivedAt (string): When the trigger was received Example: 2024-01-15T10:31:45.000Z
summary (string, required): Call summary Example: Customer called to inquire about product pricing and was transferred to sales team.
transcript (string, required): Call transcript Example: bot: Hello, how can I help you today? human: I would like to know about your pricing...