CDR API reference — Developer Guide

Query call detail records (CDR), download recordings, and export reports.

Required scope

cdr:read

Endpoints

Method	Path	Description
`GET`	`/cdr/list`	Search CDR by date range, extension, trunk, direction, status.
`GET`	`/cdr/get?call_id=c_abc`	Fetch a single call's full record.
`GET`	`/cdr/recording?call_id=c_abc`	Download the recording audio file.
`GET`	`/cdr/transcript?call_id=c_abc`	Return the AI transcript (if available).
`POST`	`/cdr/export`	Kick off an async CSV export job; poll until done.

Example response

{
  "errcode": 0,
  "total_number": 1,
  "data": [{
    "call_id": "c_abc123",
    "started_at": "2026-06-01T10:23:14Z",
    "from": "+46812345678",
    "to": "101",
    "direction": "inbound",
    "duration": 84,
    "status": "answered",
    "trunk": "Telia-Primary",
    "recording": true,
    "transcript": true
  }]
}

Common errors

40001 — Missing or invalid parameter.
40301 — API key lacks the scope this endpoint requires.
40401 — Resource not found.
50001 — Internal error; safe to retry with backoff.