Skip to main content

List Call Detail Records

GET 
/api/v1/domains/:domain_uuid/cdrs

Returns CDRs for the specified domain the caller is allowed to access.

Access rules:

  • Caller must have access to the target domain (domain scope).
  • Caller must have the xml_cdr_view permission.

Pagination (cursor-based):

  • Both limit and starting_after are optional.
  • If limit is not provided, it defaults to 500.
  • If starting_after is not provided, results start from the beginning.
  • If has_more is true, request the next page by passing starting_after equal to the last item's xml_cdr_uuid from the previous response.

Optional filters:

  • search matches caller/destination fields and status.
  • direction filters by call direction.
  • status filters by call status. Accepted values: answered, no answer, cancelled, voicemail, missed call, abandoned.
  • extension_uuid filters by extension UUID.
  • call_center_queue_uuid filters by queue UUID.
  • date_from and date_to filter by start_epoch in epoch seconds.

Examples:

  • First page: GET /api/v1/domains/{domain_uuid}/cdrs
  • Next page: GET /api/v1/domains/{domain_uuid}/cdrs?starting_after={last_xml_cdr_uuid}
  • Custom size: GET /api/v1/domains/{domain_uuid}/cdrs?limit=25
  • Search: GET /api/v1/domains/{domain_uuid}/cdrs?search=2135551212
  • Date range (epoch): GET /api/v1/domains/{domain_uuid}/cdrs?date_from=1775001600&date_to=1775087999

Request​

Responses​

Success