Developer Guides Database API StatisticsGet CDR log

Get CDR log

Retrieve the CDR log list, filtered according to the given options.

CDR data is generated immediately after a call ends, but a delay may occur between generating and registering the data, as it needs to be processed first (e.g., calculating costs).

When using the resource, up to the first 10 items of the full list can be retrieved.

Please note that when creating an API token, you can mark or unmark a checkbox that evaluates the “Allowed resources” list as a regular expression (regex). In such cases, with the GET request, query parameters are considered when running the API, so rules and restrictions can be applied to these. This is applicable when, e.g., you want to limit your API requests to certain projects (with projectid).

Tip: If you have not received a response, this may be due to a slowdown. We suggest querying the CDR data 5 minutes after sending the Webhook request. You can subsequently retry querying the CDR data every 5 minutes, up to a total of 20 times.

Request
Method	GET
Resource	https://[customer].asp.virtual-call-center.eu/v2/cdrs/[year]/[month]/[day]
Options	projectid, start, num, localtimezone
Body	N/A
Response
Body	Array of CDR objects, encoded in JSON.

Request

Resource parameters

Name	Type	Mandatory	Comment
customer	string	yes	Your call centre’s unique identifier (subdomain).
year	integer	yes	Year.
month	integer	yes	Month within the requested year. Possible values: – 01-12
day	integer	no	Day within the requested month. Possible values: – 01-31
destination	integer	no	The destination phone number related to a CDR. Only returns results if the day is not provided
direction	string	no	The sorting direction of the results. By default, results are sorted by ascending the start date. Possible values: – desc – asc

Options

Name	Type	Mandatory	Comment
num	integer	no	Specifies the maximum number of CDRs to be returned. Possible values: – [0-9]+ Without populating this parameter, the resource works with a limit of 10.
projectid	integer	no	Narrows down the scope of data to be searched in a given project.
start	integer	no	Specifies the offset of the first CDR. Possible values: – [0-9]+
localtimezone	boolean	no	Specifies whether the request should consider the global timezone for the account when filtering for dates.

Response

Response object

Name	Type	Comment
rows	array of object	Array of CDR elements.
totalCount	integer	Number of CDRs for the given period.

CDR object

Name	Type	Comment
afterwork	integer	Duration/length of afterwork, in seconds.
beforequeuetime	integer	Time spent before the call is placed in a queue (e.g. time spent in IVR), in seconds.
billing_ts	string	Time the conversation begins, in YYYY-MM-DD hh-mm-ss format.
billing_ts_utc	string	Time the conversation begins in UTC, in YYYY-MM-DD hh-mm-ss format.
billingtime	integer	Length of complete call, in seconds (including ivr, queue and conversation time, but excluding ringtime).
callfilename	string	The UUID of the related voice file.
call_rate	string	The rate applied to the call.
call_quantity	string	The quantity used for rate calculation.
currency	string	The currency used for rate calculation.
dc	string	The disconnect cause code associated with the call.
destination	string	Called phone number.
dialermode	integer	The dialer mode with which the call was made
dialermode_label	string	The dialer mode with which the call was made
dispositionid	integer	Unique disposition identifier in the database set for the call.
disposition_label	string	The label of the unique disposition identifier in the database set for the call.
disposition_comment	string	The comment added to the disposition.
dispositionreach	integer	Disposition summary. Possible values: – 1: Not reached – 2: Reached – 3: Successful
dispositionreach_label	string	Disposition summary. Possible values: – Not reached – Reached – Successful
dispositionstatus	integer	Disposition type. See: status key.
dispositionstatus_label	string	Disposition type. See: status key.
disposition_export_name	string	Export name of the disposition
direction	string	Call direction: – inbound – outbound
extensionId	integer	Unique extension identifier, if the call is an IP phone
extensionName	string	The name of the extension, if the call is an IP phone
hangup_disposition	string	Displays who hung up the call.
holdtime	integer	Duration/length of hold, in seconds.
lastArchivedTime	string	The last time the voicefile related to the CDR was archived.
lastArchivedTime_utc	string	The last time the voicefile related to the CDR was archived in UTC.
next_contact	string	The date and time when the system will try to call a specific phone number next.
next_contact_utc	string	The date and time when the system will try to call a specific phone number next in UTC.
numberid	integer	Unique record identifier in the database.
prework	integer	Duration/length of prework, in seconds.
pricetag	string	The pricetag applied to the call.
projectid	integer	Unique project identifier in the database.
projectname	string	The name of the project in the database.
queuetime	integer	If the call is placed in a queue, then the time spent in the queue, in seconds.
ringtime	integer	Duration/length of ringing, in seconds.
shortid	string	The shortid of the CDR helps connect different legs of the call.
source	string	Caller’s phone number.
start_ts	string	Time the call is initiated, in YYYY-MM-DD hh-mm-ss format.
start_ts_utc	string	Time the call is initiated in UTC, in YYYY-MM-DD hh-mm-ss format.
sum_work	string	The sum of time spent working on the call.
talktime	integer	Time during the call in which talking takes place, in seconds.
userid	integer	Unique user identifier (-1 system, otherwise agent).
uuid	string	Unique call identifier.
userfullname	string	The full name of the agent who made the call
username	string	The username of the agent who made the call
userextension	string	The extension number used for making the call
queueid	integer	Queue’s identifier.
queue_label	string	The queue’s name.
total_fee	string	The total fee applied to the call.
vcc_score	string	The scores that are relevant to the call.
recordCustomFieldData	string	The content of the custom fields associated with the call.
statusArchived	string	Displays whether the call was archived.
trashUserId	string	User ID of who put the call in the trash.
deletedUserId	string	User ID of who deleted the call.
amd	integer	Indicates whether AMD detection was performed on a call or not. Possible values: – 1: Yes – 0: Nol
destination_name	string	The label of the phone number that was called
routing_id	string	The name of the routing.
qm	integer	The aggregate quality management score of the call.

Example

List the first CDR in November 2014.

Request

https://mycc.asp.virtual-call-center.eu/v2/cdrs/2014/11?start=0&num=1

Response body

{
    "response": {
        "rows": [
            {
                "uuid": "99be495e-9a77-da3b-4924-1e591fe98b67",
                "source": "3624998131",
                "shortid": "BC8QKNS7",
                "destination": "36304729211",
                "userid": 498,
                "numberid": 7,
                "start_ts": "2025-04-16 11:19:59",
                "billing_ts": "2025-04-16 11:20:07",
                "ringtime": 8,
                "billingtime": 22,
                "talktime": 22,
                "queuetime": 0,
                "beforequeuetime": 0,
                "dispositionid": 11,
                "dispositionreach": 3,
                "dispositionstatus": 5,
                "projectid": 768,
                "holdtime": 0,
                "afterwork": 10,
                "prework": 10,
                "direction": "outbound",
                "sum_work": "00:00:50",
                "queueid": 0,
                "next_contact": "2025-04-16 11:20:39",
                "call_rate": "7.300000",
                "call_quantity": "0.366667",
                "currency": "huf",
                "dialermode": 2,
                "dc": 16,
                "disposition_comment": "Automatikus termináció rögzítés hard limit elérése miatt",
                "pricetag": "hu-out-mobile-eu",
                "total_fee": "2.676667",
                "hangup_disposition": "operator",
                "vcc_score": null,
                "recordCustomFieldData": null,
                "callfilename": "99be495e-9a77-da3b-4924-1e591fe98b67",
                "routing_id": "global_routing",
                "qm": null,
                "amd": 0,
                "statusArchived": "no",
                "lastArchivedTime": null,
                "trashUserId": null,
                "deletedUserId": null,
                "recStatus": "active",
                "special": false,
                "dispositionreach_label": "Success",
                "dispositionstatus_label": "Finished",
                "dialermode_label": "Manual",
                "queue_label": null,
                "disposition_label": "Closed support",
                "disposition_export_name": "Elsőre lezárt tanácsadás",
                "projectname": "Demo",
                "userfullname": "Tóth János",
                "username": "toth_janos",
                "userextension": "623",
                "destination_name": null,
                "start_ts_utc": "2025-04-16 09:19:59",
                "billing_ts_utc": "2025-04-16 09:20:07",
                "next_contact_utc": "2025-04-16 09:20:39",
                "lastArchivedTime_utc": null
            }
        ],
        "totalCount": 1
    },
    "errors": []
}

Comments

Can’t find what you need? Use the comment section below to connect with others, get answers from our experts, or share your ideas with us.

There are no comments yet.

Click here to cancel reply.