• Partners
  • Email Us
  • Product
    • Channels
      • Voice
      • Email
      • SMS
      • Chat
      • Messenger
      • Omnichannel
    • Features
      • Predictive Dialer
      • VCC Live Pay
      • Outbound IVR
      • Inbound IVR
      • Voicemail Detection
      • Live Dashboards
      • ACD
      • Salesforce Integration
      • Dialogflow
  • Solutions
    • Customer Service
    • Sales Teams
    • Debt Collection
    • Virtual Call Center
  • Pricing
  • Resources
    • Blog
    • Case Studies
    • Ebooks
    • Courses
    • Webinars
    • Information Security
    • Learning Center
    • Developers
  • Company
    • About us
    • Careers
    • News
    • Partners
  • Partners
  • Email Us
+44 208 638 0169
GET STARTED
Developer GuidesDatabase APIStatisticsGet CDR log
  • Overview
    • About Database API
    • The API location
    • Authentication and Security
    • Testing API
    • Request and Response
    • HTTP Response Codes
  • Examples
    • Hello World Example
    • Advanced Example
    • Web Callback Example
  • Reference
  • Project
    • List projects
    • List project outbound numbers
    • Get project parameters
    • Cloning projects
    • Get quota limits
    • Modify quota limits
  • Database
    • Add field and values
    • Add new value(s) to a field
    • Modify value(s) of a field
    • Delete a value
    • List records
    • Get detailed record information
    • Modify record
    • Modify contact
    • Add record
    • Add disposition
    • Batch record modification
    • Batch disposition modification
    • Add new value to Robinson list
    • Delete from Robinson list resource
  • Statistics
    • Dashboard API
    • Get CDR log
    • Get CDR log for a specified uuid
    • Get Email Log
    • Get voicefile for a specified CDR
    • Get inbound statistics
    • Get call statistics
    • User state log
    • User based statistics
    • User based model
    • Number of available agents in a queue
    • User's Current Status
  • Users
    • List users
    • Add new user
    • List teams
    • List all roles
    • User's Current Status
  • Archiver
    • Get the year and month when no voicefiles were archived
    • List all downloadable voice files in a given month
    • Set a successfully downloaded voicefile as archived
    • Download voice file
  • Campaign Manager
    • Get Database
    • Get Fields
    • Add Customer
    • Modify Customer
Back to Support and Learning Center
English Hungarian

Get CDR log

Retrieve CDR log list, filtered according to 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 firstly (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 too 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
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 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.
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.
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
holdtime integer Duration/length of hold, in seconds.
next_contact string The date and time when the system will try to call a specific phone number next.
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.
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 indetifier.

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": "d3c584b4-5f38-11e9-81be-eb8ee87cf8bf",
      "source": "3433335343",
      "shortid": "9S8G4J56",
      "destination": "3434334333",
      "userid": 0,
      "numberid": 0,
      "extensionId": "1600",
      "extensionName": "LMR",
      "start_ts": "2019-04-15 06:42:08",
      "billing_ts": "2019-04-15 06:42:09",
      "ringtime": 0,
      "billingtime": 223,
      "talktime": 223,
      "queuetime": 0,
      "beforequeuetime": 0,
      "dispositionid": 0,
      "dispositionreach": 0,
      "dispositionstatus": 0,
      "projectid": 370,
      "userfullname": "Jack White",
      "username": "vcc_jack_white_op",
      "userextension": "339",
      "holdtime": 0,
      "afterwork": 0,
      "prework": 0,
      "direction": "inbound",
      "sum_work": "00:03:43",
      "queueid": 0,
      "next_contact": "0000-00-00 00:00:00",
      "call_rate": "0.000000",
      "call_quantity": "3.716667",
      "currency": "huf",
      "dialermode": 1,
      "dc": 16,
      "disposition_comment": null,
      "pricetag": "hu-in-landline",
      "total_fee": "0.000000",
      "hangup_disposition": "operator",
      "vcc_score": null,
      "recordCustomFieldData": null,
      "statusArchived": "no",
      "lastArchivedTime": null,
      "trashUserId": null,
      "deletedUserId": null
            }
        ],
        "totalCount": 1
    },
    "errors": []
}
Back to Support and Learning Center

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.

Please note that by clicking on the Submit button, you agree to a member of VCC Live team contacting you with business offers. You can find detailed information on how we can establish contact with you in our Privacy Policy

  • Channels
    • Voice
    • Email
    • SMS
    • Chat
    • Messenger
    • Omnichannel
  • Main Features
    • Call Center Software
    • Predictive Dialer
    • VCC Live Pay
    • Outbound IVR
    • Inbound IVR
    • Voicemail Detection
    • Live Dashboards
    • ACD
    • Salesforce Integration
    • Dialogflow
  • Solutions
    • Customer Service
    • Sales Teams
    • Debt Collection
    • Virtual Call Center
  • Resources
    • Blog
    • Case Studies
    • Ebooks
    • Courses
    • Webinars
    • Information Security
    • Learning Center
    • Developers
    • Download
  • Company
    • About us
    • Careers
    • News
    • Partners
https://vcc.live/wp-content/uploads/2019/07/iso-cert-1.png https://vcc.live/wp-content/uploads/2019/07/iso-cert-2.png https://vcc.live/wp-content/uploads/2019/07/iso-cert-3.png
Social Media
https://vcc.live/wp-content/uploads/2019/07/linkedin.svg https://vcc.live/wp-content/uploads/2019/07/twitter.svg https://vcc.live/wp-content/uploads/2019/07/facebook-1.svg https://vcc.live/wp-content/uploads/2019/07/instagram-1.svg
Call us
Hungary
+36 19996400
UK
+44 2086380169
Germany
+49 3021782516
Poland
+48 123950886
Romania
+40 31706167
USA
+1 3024988337
Hungary
+36 19996400
UK
+44 2086380169
Germany
+49 3021782516
Poland
+48 123950886
Romania
+40 31706167
USA
+1 3024988337
  • Privacy Policy
  • Cookie Policy
  • Legal Statement
  • General Terms of Agreement
  • Magyar nyelvű jogi dokumentumok