Skip to main content
GET
List Call Logs

Authorizations

Authorization
string
header
required

Access Token or Private Integration Token

Headers

Version
enum<string>
required

API Version

Available options:
2021-04-15

Query Parameters

locationId
string
required

Location identifier. Filters results to this location.

agentId
string

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

Example:

"507f1f77bcf86cd799439011"

contactId
string

Contact IDs (comma-separated) to filter by.

Example:

"contact123,contact456"

callType
enum<string>

Call type filter.

Available options:
LIVE,
TRIAL
startDate
number

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

Example:

1679308800000

endDate
number

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

Example:

1679395199000

actionType
enum<string>

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

Available options:
CALL_TRANSFER,
DATA_EXTRACTION,
IN_CALL_DATA_EXTRACTION,
WORKFLOW_TRIGGER,
SMS,
APPOINTMENT_BOOKING,
CUSTOM_ACTION,
KNOWLEDGE_BASE
Example:

"SMS,CALL_TRANSFER,WORKFLOW_TRIGGER"

sortBy
enum<string>

Field to sort by. Defaults to newest if omitted.

Available options:
duration,
createdAt
sort
enum<string>

Sort direction. Applies only when sortBy is provided.

Available options:
ascend,
descend
page
number
default:1

Page number (1-based).

pageSize
number
default:10

Page size (max 50).

Response

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

Last modified on March 7, 2026