API : MVNO CDR

Introduction

This request will return CDR data for the MVNO account.

This is a limited view into the CDR records. To access CDR data with all the details, you must access it via the CDR API.

Request

URL	https://api.telecomx.dk/mvno/ACCOUNT_ID/cdr
Method	GET
Access level	VIEWER, MANAGER or OWNER if user belongs to the customer. RESELLER if customer belongs to the reseller. RESELLER_ADMIN. ADMIN.
Param	ACCOUNT_ID	Id of the MVNO account (24 hex-char string). An account of another type is not found on this URL.
Query	fromDate	`[optional]` First day to return CDR records for, any ISO 8601 date (e.g. 2026-07-23 or 2026-07-23T00:00:00Z). The time of day is ignored - the day starts at 00:00 Danish time. Defaults to today.
	toDate	`[optional]` Last day to return CDR records for, same format. The day ends at 23:59:59 Danish time. Defaults to today.
	limit	`[optional]` Max number of CDR records to return, default 100 (1-1000000). Excel output is capped at 65000 rows.
	offset	`[optional]` Offset for paging, index of first CDR record to return, default 0.
	filter	`[optional]` Search text that looks into A number, B number, users name and users extension. Case-insensitive, every word must match.
	direction	`[optional]` Direction of the call, 'IN' or 'OUT'. Any other value, or omitted, returns both directions.
	format	`[optional]` Format for output: json (default), csv or excel. Any other value gives json.

A request matching more than 300000 CDR records is refused - ask for a shorter period.

Query example

https://api.telecomx.dk/mvno/1234567890ABCDEF12345678/cdr
https://api.telecomx.dk/mvno/1234567890ABCDEF12345678/cdr?fromDate=2026-07-23
https://api.telecomx.dk/mvno/1234567890ABCDEF12345678/cdr?fromDate=2026-07-23&toDate=2026-07-31&limit=1000&offset=100&filter=12345678
https://api.telecomx.dk/mvno/1234567890ABCDEF12345678/cdr?fromDate=2026-07-23&toDate=2026-07-31&limit=1000000&format=csv

Response

If format is CSV or Excel the response is a file for download (cdr.csv or cdr.xlsx) with the columns type, aNumber, bNumber, diverter, start, length, talkLength (only if the customer uses duration method 1), terminationCause, terminatedBy, destination, roaming (1 or 0), roamingCountry, roamingRegion, price, userName, userLocation, userExtension. The destination column is a text, e.g. 'DK fixed', 'DK mobile' or the name of a danish special number; the start column is dd-MM-yyyy hh:mm:ss in CSV and a Danish date and time in Excel; the CSV price uses a comma as decimal separator. If format is JSON, the below applies.

Calls to or from the helplines 116111 and 1888 are only included for ADMIN users.

JSON object
offset	Number	Index of the first CDR record returned.
limit	Number	Number of CDR records to return. Note that the actual number of CDR records returned may be lower.
total	Number	Number of CDR records that can be returned when offset and limit is not considered. This is to be used for paging through the data.
cdr	Array	Array of CDR records, see definition below. When both limit and total are above 20000 the records are streamed and the array is named cdrs instead.

CDR record object (JSON)
_id	Id	Unique id of the CDR record.
type	String	Type and direction of the call: MVNO_INBOUND, MVNO_OUTBOUND.
aNumber	String	The number presented by the caller, E.164 format. If the type is MVNO_INBOUND and the caller is using secret number then the number will be 'HIDDEN', unless the user is ADMIN.
aNumberSecret	Boolean	True if aNumber is secret and not to be presented.
bNumber	String	The number called, E.164 format.
diverter	String	If the call is a diverted call, this is the E.164 number of the one who diverted the call.
start	Date	Date and time the call started.
length	Integer	The length of the call in seconds, 0 if the call was not answered.
talkLength	Integer	The length of the call after answer in seconds. Only present if the customer uses duration method 1.
terminationCause	String	The reason for the call to end: HANGUP - call hang up BUSY - callee is busy NO_ANSWER - callee did not answer BLACKLISTED - called number is blacklisted BLOCKED - caller is not allowed to call the callee (highrate/international/all blocking) ERROR - call failed NOT_FOUND - callee does not exist FRAUD - call terminated due to fraud
terminatedBy	String	Who terminated the call: A = caller, B = callee, S = system.
destination.country	String	The ISO3166-2 country code of the destination country.
destination.type	String	The type of destination 'fixed', 'mobile', 'special', 'dkspecial'.
destination.name	String	If the type is 'dkspecial', the call is towards a danish special number, 112, 114, 1813 etc., and this contains a precise description in danish of the destination (e.g. 1813 Akuttelefonen region hovedstaden).
userName	String	Name of the person making the call (if set by PBX).
userLocation	String	Location of the person making the call (if set by PBX).
userExtension	String	Local extension number of the person making the call (if set by PBX).
roaming	Boolean	True if the user was roaming while the call was made.
roamingCountry	String	Name of the country the user was roaming in, if roaming.
roamingRegion	Id	Id of the roaming region that was roamed in, if roaming.
connectionFeePrice	Number	Connection fee for the customer.
minutesPrice	Number	Price of the minutes for the customer.
price	Number	Total price of the call for the customer, connectionFeePrice + minutesPrice, 3 decimals.

An ADMIN receives the complete stored CDR record, which additionally holds callId, sbcServer, voiceAccount, customer, ratePlan, connectionFeeCost, connectionFeeWholesale, minutesCost, minutesWholesale, vatExemption, invoiced, roamingNetwork, accessNetworkInfo and rtpStat.

If a call originates from a PBX, then the PBX can add SIP headers to the outbound call to indicate the name of the caller, the location of the caller and the local extension number of the caller. These data will automatically be added to the CDR record if available.

Example

{
  "offset": 0,
  "limit": 100,
  "total": 548,
  "cdr": [
    {
      "_id": "650000000000000000000001",
      "type": "MVNO_OUTBOUND",
      "aNumber": "+4581808888",
      "aNumberSecret": false,
      "bNumber": "+4570305050",
      "diverter": null,
      "start": "2026-07-23T12:34:56.123Z",
      "length": 78,
      "terminationCause": "HANGUP",
      "terminatedBy": "B",
      "destination": { "country": "DK", "type": "mobile", "name": null },
      "userName": "Hans Hansen",
      "userLocation": "CPH office",
      "userExtension": "211",
      "roaming": false,
      "roamingCountry": null,
      "roamingRegion": null,
      "connectionFeePrice": 0.1,
      "minutesPrice": 0.325,
      "price": 0.425
    }
  ]
}

Errors

Error code	Message	Description
422	id	Invalid input for the named property - the URL parameter failed validation
404	id	Not found
403	access_denied	Insufficient access level
422	count	CDR amount exceeds the maximum - please request CDR for a shorter timeframe
500	internal_error	<Unspecified>

WIKI

Table of Contents