Query Call Detail Records (CDRs)

GET

/reports/cdrs

const url = 'https://pbx.ring2all.com/api/v1/reports/cdrs?start_date=2026-09-01T00%3A00%3A00Z&end_date=2026-09-10T23%3A59%3A59Z&disposition=ANSWERED';
const options = {method: 'GET', headers: {'X-API-Key': '<X-API-Key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://pbx.ring2all.com/api/v1/reports/cdrs?start_date=2026-09-01T00%3A00%3A00Z&end_date=2026-09-10T23%3A59%3A59Z&disposition=ANSWERED' \
  --header 'X-API-Key: <X-API-Key>'

Queries historical CDRs with duration, quality metrics (MOS, packet loss, jitter), and carrier billing cost.

Authorizations

ApiKeyAuth
BearerAuth

Parameters

Query Parameters

start_date

required

string format: date-time

Example

2026-09-01T00:00:00Z

end_date

required

string format: date-time

Example

2026-09-10T23:59:59Z

disposition

string

Allowed values: ANSWERED BUSY NO ANSWER FAILED

Responses

200

Filtered CDR records

application/json

object

total_calls

integer

total_billsec

integer

records

Array<object>

object

call_uuid

string

caller_id_number

string

destination_number

string

start_stamp

string format: date-time

billsec

integer

disposition

string

mos_score

number format: float

cost

number format: float

Example

{
  "total_calls": 3420,
  "total_billsec": 184520,
  "records": [
    {
      "call_uuid": "a7c2b3e4-d5f6-4a1b-8c2d-9e0f1a2b3c4d",
      "caller_id_number": "+13055551234",
      "destination_number": "1001",
      "start_stamp": "2026-09-10T14:22:10Z",
      "billsec": 142,
      "disposition": "ANSWERED",
      "mos_score": 4.38,
      "cost": 0.0234
    }
  ]
}