Skip to main content

ListCallLogs lists call logs with filtering and pagination.

GET 
/api/v1/voice/call-logs

Returns CDRs matching the specified criteria.

Pagination​

  • page: Page number (default: 1)
  • per_page: Results per page (default: 20, max: 100)

Filtering​

  • start_date/end_date: Date range filter
  • direction: inbound, outbound, or internal
  • status: answered, no_answer, busy, failed
  • agent_id: Filter by agent
  • queue_id: Filter by queue
  • campaign_id: Filter to calls belonging to a specific campaign
  • campaign_contact_id: Filter to every call attempt made for a specific campaign contact (retries, reschedules, etc.)
  • search: Search in phone numbers

Identifying Campaign Calls in the Response​

Every call log carries optional campaign_id and campaign_contact_id fields. When populated the call originated from the campaign dialer; when null the call came from a manual dial, an inbound route, or a pre-campaign-correlation migration (000176) record. Clients can use the presence of campaign_id to tag/badge campaign calls in list views without issuing a second request.

Errors​

  • PERMISSION_DENIED: Caller lacks voice:cdr:read permission

Request​

Responses​

A successful response.