API : PBX : CDR

This request returns a list of call detail records.

https://api.telecomx.dk/pbx/cdr
https://api.telecomx.dk/pbx/cdr?customer=1234578901234567890ABCD&extension=12345678901234567890AAAA&terminatedReason=CANCEL&filter=203
https://api.telecomx.dk/pbx/cdr?from=2019-01-01T00:00:00.000Z&to=2019-01-02T00:00:00.000Z

{
  "offset": 0,
  "limit": 100,
  "total": 7,
  "cdrs": [
    {
      "_id": "5d035c832d357b369b6f7aff",
      "pbx": "pbx3.telecomx.dk",
      "channelId": "1560501368.50818",
      "callId": "9f09cceff8250a4e",
      "started": "2019-06-14T08:36:08.791Z",
      "answered": null,
      "answeredByCallee": false,
      "ended": "2019-06-14T08:36:19.523Z",
      "caller": {
        "number": "210",
        "name": "Per Møller",
        "extension": "5cfd1d10327c3b67a69883c6",
        "sipPhone": "5c5aaa7a83a3bc74d5891d29"
      },
      "callee": {
        "number": "432",
        "name": "Michael Hansen",
        "extension": "5c52a38ddd7b982b96d4aacc"
      },
      "recording": [
        {
          "_id": "12345678901234567890AAEE",
          "by": "EMPLOYEE",
          "employee": "12345678901234567890FEDE",
          "length": 120,
          "followUp": true,
          "followUpNote": "Call back and make invoice"
        }
      ],
      "customer": "52f4fd7734697b28ccaf77ec",
      "terminatedBy": "A",
      "terminatedReason": "HANGUP",
      "cdrNote": "This is a note",
      "quality": {
        "verdict": "DEGRADED",
        "measured": true,
        "severity": 2,
        "worst": {
          "code": "INBOUND_DELIVERY_LOW",
          "role": "caller",
          "party": { "kind": "SIP_PHONE", "model": "Mitel-6867i", "raw": "SIPPHONE/Mitel-6867i" },
          "direction": "INBOUND",
          "percentMissing": 16
        }
      }
    },
    {
      ...
    }
  ]
}

One physical call produces several CDR records: a phone-initiated blind transfer, a hop to another PBX node, a dialplan re-entry, a pickup or a steal each start a new call leg, and a transfer made from the app closes the running record and starts another one. Listed flat, those records look like several overlapping calls from the same number - which is what group=call exists to fix.

With group=call:

• One row per call. The row is the call's first leg with the call-level facts written over it:

started is the earliest leg's, ended the latest leg's, answered the first answer,

  and ''callee'', ''terminatedBy'' and ''terminatedReason'' come from the LAST leg - where the
  call actually ended up.
* ''answeredByCallee'' is true when ANY leg was answered by a person. It is the field to render
  "answered" from: a caller who waited in a queue and gave up has ''answered'' set (the system
  answered, to play audio) but ''answeredByCallee'' false, and ''terminatedReason'' says HANGUP.
* ''quality'', where the caller is entitled to see it at all, is the worst badge across the legs,
  and ''recording'' is the union of the legs' recordings.
* A call is returned WHOLE when any one of its legs matches the filters, so filtering on an
  extension or a number returns the other legs of that call as well.
* Access is unaffected. A PERSONAL user still only sees calls that touch their own extensions.
* Records with no ''callRef'' - every call handled before call grouping was introduced - form a
  group of one and come back exactly as they do with ''group=leg''.

CSV and EXCEL exports are always ungrouped, one line per leg, regardless of group.

Audio quality is TX staff only (changed 27-08-2026). For ADMIN, and for RESELLER_ADMIN with the TELE employee feature, every CDR carries a quality badge and the CSV and EXCEL exports carry the verdict in a Lydkvalitet column. For everybody else the quality field is absent entirely and the export has no such column - an integration that reads the column by name must tolerate it not being there.

Full per-leg detail for one call is available from CDR quality, and the calls with the worst audio in a period from Call audio quality : Calls.