Get CDR log

Retrieve CDR log list, filtered according to given options.

Note: 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 firstly (e.g. calculating costs).

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
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

Options

Name Type Mandatory Comment
num integer no Specifies the maximum number of CDRs to be returned. Possible values:
– [0-9]+
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]+

Response

Response object

Name Type Comment
rows array of object Array of CDR elements.
totalCount integer Number of CDRs returned.

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.
billingtime integer Length of complete call, in seconds (including ivr, queue and conversation time, but excluding ringtime).
destination string Called phone number.
dispositionid integer Unique disposition identifier in the database set for the call.
dispositionreach integer Disposition summary. Possible values:
– 1: not reached
– 2: reached
– 3: successful
dispositionstatus integer Disposition type. See: status key.
direction string Call direction:
– inbound
– outbound
holdtime integer Duration/length of hold, in seconds.
numberid integer Unique record identifier in the database.
prework integer Duration/length of prework, in seconds.
projectid integer Unique project identifier 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.
source string Caller’s phone number.
start_ts string Time the call is initiated, in YYYY-MM-DD hh-mm-ss format.
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.

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": "95bd5f46-44e0-11e5-a6da-6547f8762750",
                "source": "3619980106",
                "destination": "3619996400",
                "userid": 6,
                "numberid": 11,
                "start_ts": "2015-08-17 15:05:08",
                "billing_ts": "2015-08-17 15:05:17",
                "ringtime": 9,
                "billingtime": 3,
                "talktime": 3,
                "queuetime": 0,
                "beforequeuetime": 0,
                "dispositionid": 3,
                "dispositionreach": 1,
                "dispositionstatus": 3,
                "projectid": 3,
                "holdtime": 0,
                "afterwork": 9,
                "prework": 0,
                "direction": "outbound"
            }
        ],
        "totalCount": 1
    },
    "errors": []
}

There are no comments yet.

Comment

Subscribe to our newsletter
or Contact us!