Get mobile CDR log

Reading Time: 2 minutes

Retrieve mobile CDR list, filtered according to given options.

Note: When using the resource, you can get up to the first 10 items of the full list.

Method GET
Resource https://[customer][year]/[month]/[day]
Options projectid, start, num
Body N/A
Body Array of Mobile CDR objects, encoded in JSON.


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


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 object

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

CDR object

Name Type Comment
destination string Called phone number.
direction string Call direction:
– inbound
– outbound
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.
numberid integer Unique record identifier in the database.
projectid integer Unique project identifier in the database.
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.
uuid string Unique call identifier.


List the first Mobile CDR in June, 2016.


Response body

    "response": {
        "rows": [
                "uuid": "29a16a57-2801-43a5-b04c-65eeaa40de78",
                "source": "36201233456",
                "destination": "3619996400",
                "userid": 81,
                "numberid": 503,
                "start_ts": "2016-06-02 15:43:45",
                "talktime": 40,
                "dispositionid": 15,
                "dispositionreach": 2,
                "dispositionstatus": 5,
                "projectid": 2,
                "direction": "outbound"
        "totalCount": 1
    "errors": [

There are no comments yet.
Subscribe to our newsletter
or Contact us!
Please note that by subscribing to our newsletter, you agree to receive regular email messages from VCC Live® about service related news and updates. By subscribing to our newsletter, you also agree that VCC Live® will use your data in accordance with the applicable Privacy Policy until you unsubscribe from the newsletter.