CDR

List call records

Returns all CDRs for your account. Supports filtering by phone numbers, date range, call direction, duration, and pagination.

get/api/v1/Account/{auth_id}/cdr

Path parameters

auth_idstring required
Example:MA_XXXXXX

Your account Auth ID

Query parameters

from_numberstring
Example:9876543210

Filter by the originating phone number (caller).

to_numberstring
Example:1234567890

Filter by the destination phone number (callee).

start_datestring date
Example:2026-03-01

Beginning of the search period (YYYY-MM-DD). Required when using end_date.

end_datestring date
Example:2026-03-17

End of the search period (YYYY-MM-DD). Required when using start_date.

call_direction'inbound' | 'outbound'

Filter by direction.

min_durationinteger
Example:10

Minimum call duration in seconds. Excludes calls shorter than this value.

sip_call_idstring
Example:dD1qwu5VZ5iK3ed5u3uspjY5RKL

Filter by the SIP Call-ID of the call (matches the cdr's sip_call_id field).

bridge_uuidstring
Example:4b7ae653-f40d-42f1-b582-6b05dfcd0c0a

Filter by the UUID of the bridged leg (matches the cdr's bridge_uuid field).

hangup_causestring
Example:NORMAL_CLEARING

Filter by telephony hangup cause, e.g. NORMAL_CLEARING.

hangup_dispositionstring
Example:send_refuse

Filter by how the leg was released, e.g. send_refuse.

contextstring
Example:sip-trunking

Filter by the call context, e.g. sip-trunking.

campaign_idstring

Filter by the campaign identifier associated with the call.

searchstring

Free-text search across CDR fields (numbers, IDs, etc.).

pageinteger

Page number for paginated results.

per_pageinteger

Number of records per page. Max: 100.

Response

Paginated list of CDRs

account_idstring required
countinteger required
successboolean required

Changes

No recorded changes to this endpoint across all 1 revision of this API.