Call Detail Records
Manage your call detail records.
Retrieve a collection of call detail records.
GET /api/cdrs HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"count": 100,
"items": [
{
"id": "NzAwNTUxOTA5NzczMTQ4MTYw",
"caller": "text",
"caller_domain": "text",
"caller_display_name": "text",
"callee": "text",
"callee_domain": "text",
"callee_display_name": "text",
"started_at": "2017-07-21T17:32:28Z",
"rang_at": "2017-07-21T17:32:28Z",
"answered_at": "2017-07-21T17:32:28Z",
"ended_at": "2017-07-21T17:32:28Z",
"call_id": "text",
"direction": "INBOUND_CALL",
"end_reason": "CALLER_DISCONNECTED",
"reroute_reason": "TRANSFER",
"status_code": 1,
"destination": "text",
"outbound_caller_id": "text",
"did_cid": "text",
"trunk": "text",
"duration": 1,
"service_number": "text",
"user_data": "text"
}
]
}
Retrieve details of CDR.
The unique ID of CDR.
The unique ID of the resource.
NzAwNTUxOTA5NzczMTQ4MTYw
GET /api/cdrs/{id} HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"items": [
{
"caller": "text",
"caller_domain": "text",
"caller_display_name": "text",
"callee": "text",
"callee_domain": "text",
"callee_display_name": "text",
"started_at": "2017-07-21T17:32:28Z",
"rang_at": "2017-07-21T17:32:28Z",
"answered_at": "2017-07-21T17:32:28Z",
"ended_at": "2017-07-21T17:32:28Z",
"call_id": "text",
"direction": "INBOUND_CALL",
"end_reason": "CALLER_DISCONNECTED",
"reroute_reason": "TRANSFER",
"status_code": 1,
"destination": "text",
"outbound_caller_id": "text",
"did_cid": "text",
"trunk": "text",
"duration": 1,
"cost": 1,
"billed_account": "text",
"service_number": "text",
"user_data": "text"
}
]
}
Retrieve a collection of call logs.
GET /api/calllogs HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"count": 100,
"items": [
{
"id": "NzAwNTUxOTA5NzczMTQ4MTYw",
"session_id": "NzAwNTUxOTA5NzczMTQ4MTYw",
"caller": "text",
"caller_domain": "text",
"caller_display_name": "text",
"callee": "text",
"callee_domain": "text",
"callee_display_name": "text",
"started_at": "2017-07-21T17:32:28Z",
"rang_at": "2017-07-21T17:32:28Z",
"answered_at": "2017-07-21T17:32:28Z",
"ended_at": "2017-07-21T17:32:28Z",
"call_id": "text",
"direction": "INBOUND_CALL",
"end_reason": "CALLER_DISCONNECTED",
"reroute_reason": "TRANSFER",
"status_code": 1,
"destination": "text",
"outbound_caller_id": "text",
"did_cid": "text",
"trunk": "text",
"duration": 1,
"service_number": "text",
"user_data": "text"
}
]
}
Retrieve details of call log.
The unique ID of CDR.
The unique ID of the resource.
NzAwNTUxOTA5NzczMTQ4MTYw
GET /api/calllogs/{id} HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"id": "NzAwNTUxOTA5NzczMTQ4MTYw",
"session_id": "NzAwNTUxOTA5NzczMTQ4MTYw",
"caller": "text",
"caller_domain": "text",
"caller_display_name": "text",
"callee": "text",
"callee_domain": "text",
"callee_display_name": "text",
"started_at": "2017-07-21T17:32:28Z",
"rang_at": "2017-07-21T17:32:28Z",
"answered_at": "2017-07-21T17:32:28Z",
"ended_at": "2017-07-21T17:32:28Z",
"call_id": "text",
"direction": "INBOUND_CALL",
"end_reason": "CALLER_DISCONNECTED",
"reroute_reason": "TRANSFER",
"status_code": 1,
"destination": "text",
"outbound_caller_id": "text",
"did_cid": "text",
"trunk": "text",
"duration": 1,
"cost": 1,
"billed_account": "text",
"service_number": "text",
"user_data": "text"
}
Use the filter
query parameter to retrieve just a subset of a collection.
Use the search
query parameter to restrict the results of a request to match a search criterion.
Use the orderby
query parameter to specify the sort order of the items returned from server.
The default order is ascending order.
Use the skip
query parameter to set the number of items to skip at the start of a collection.
0
Use the top
query parameter to specify the page size of the result set.
100
GET /api/call_reports HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"count": 100,
"items": [
{
"id": "NzAwNTUxOTA5NzczMTQ4MTYw",
"name": "text",
"type": "NORMAL",
"cron_expr": "text",
"status": "RUNNING"
}
]
}
The name of call report.
The report types can be either:
NORMAL
:EXTENSION_GROUP_CALL_COST
:QUEUE_PERFORMANCE
:QUEUE_DETAILED_STATISTICS
:QUEUE_ABANDONED_CALLS
:QUEUE_SLA_STATISTICS
:QUEUE_BREACHES_SLA_STATISTICS
:QUEUE_CALLBACKS
:QUEUE_FAILED_CALLBACKS
:TEAM_QUEUE_GENERAL_STATISTICS
:RING_GROUP_STATISTICS
:
The email address to which the report file will be sent after the report is complete.
The report output files format can be either:
CSV
:HTML
:
The report range can be either:
TODAY
: the day the report was generated.YESTERDAY
: yesterday of the day the report was generated.LAST_WEEK
: the last week of the day the report was generated.LAST_SEVEN_DAYS
: seven days before the day the report was generated.LAST_MONTH
: the last month of the day the report was generated.LAST_THIRTY_DAYS
: thirty days before the day the report was generated.CUSTOM
: custom date range.
Filter data after specified data time.
Only valid when the range
is specified as CUSTOM
The RFC 3339 format is defined by The date_time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
2017-07-21T17:32:28Z
Filter data before specified data time.
Only valid when the range
is specified as CUSTOM
The RFC 3339 format is defined by The date_time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
2017-07-21T17:32:28Z
The crontab expression https://en.wikipedia.org/wiki/Cron
POST /api/call_reports HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 326
{
"name": "text",
"type": "NORMAL",
"email": "[email protected]",
"format": "CSV",
"range": "TODAY",
"started_at": "2017-07-21T17:32:28Z",
"ended_at": "2017-07-21T17:32:28Z",
"cron_expr": "text",
"filter": {
"from": "ANY",
"from_value": "text",
"to": "ANY",
"to_value": "text",
"answer_state": "ANY",
"duration": "ANY",
"duration_from": 1,
"duration_to": 1
}
}
{
"id": "NzAwNTUxOTA5NzczMTQ4MTYw"
}
Get details of call report by it's unique ID.
The unique ID of this call report.
The unique ID of the resource.
NzAwNTUxOTA5NzczMTQ4MTYw
GET /api/call_reports/{id} HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"id": "NzAwNTUxOTA5NzczMTQ4MTYw",
"name": "text",
"type": "NORMAL",
"email": "[email protected]",
"format": "CSV",
"range": "TODAY",
"started_at": "2017-07-21T17:32:28Z",
"ended_at": "2017-07-21T17:32:28Z",
"cron_expr": "text",
"filter": {
"from": "ANY",
"from_value": "text",
"to": "ANY",
"to_value": "text",
"answer_state": "ANY",
"duration": "ANY",
"duration_from": 1,
"duration_to": 1
},
"status": "RUNNING"
}
Update call report properties.
The unique ID of this call report.
The unique ID of the resource.
NzAwNTUxOTA5NzczMTQ4MTYw
The name of call report.
The email address to which the report file will be sent after the report is complete.
The report output files format can be either:
CSV
:HTML
:
The report range can be either:
TODAY
: the day the report was generated.YESTERDAY
: yesterday of the day the report was generated.LAST_WEEK
: the last week of the day the report was generated.LAST_SEVEN_DAYS
: seven days before the day the report was generated.LAST_MONTH
: the last month of the day the report was generated.LAST_THIRTY_DAYS
: thirty days before the day the report was generated.CUSTOM
: custom date range.
Filter data after specified data time.
Only valid when the range
is specified as CUSTOM
The RFC 3339 format is defined by The date_time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
2017-07-21T17:32:28Z
Filter data before specified data time.
Only valid when the range
is specified as CUSTOM
The RFC 3339 format is defined by The date_time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
2017-07-21T17:32:28Z
The crontab expression https://en.wikipedia.org/wiki/Cron
POST /api/call_reports/{id} HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 310
{
"name": "text",
"email": "[email protected]",
"format": "CSV",
"range": "TODAY",
"started_at": "2017-07-21T17:32:28Z",
"ended_at": "2017-07-21T17:32:28Z",
"cron_expr": "text",
"filter": {
"from": "ANY",
"from_value": "text",
"to": "ANY",
"to_value": "text",
"answer_state": "ANY",
"duration": "ANY",
"duration_from": 1,
"duration_to": 1
}
}
No content
Destroy call report by it's unique ID.
The unique ID of this call report.
The unique ID of the resource.
NzAwNTUxOTA5NzczMTQ4MTYw
POST /api/call_reports/{id}/destroy HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
Use the filter
query parameter to retrieve just a subset of a collection.
Use the search
query parameter to restrict the results of a request to match a search criterion.
Use the orderby
query parameter to specify the sort order of the items returned from server.
The default order is ascending order.
Use the skip
query parameter to set the number of items to skip at the start of a collection.
0
Use the top
query parameter to specify the page size of the result set.
100
GET /api/completed_call_reports HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"count": 100,
"items": [
{
"id": "NzAwNTUxOTA5NzczMTQ4MTYw",
"name": "text",
"type": "NORMAL",
"format": "CSV",
"completed_at": "2017-07-21T17:32:28Z",
"file_name": "text",
"file_size": 0,
"file_url": "/api/blobs/WexWdABcd5D4PDgzTKV3gAAAEu00WcK"
}
]
}
Get details of completed call report by it's unique ID.
The unique ID of this call report.
The unique ID of the resource.
NzAwNTUxOTA5NzczMTQ4MTYw
GET /api/completed_call_reports/{id} HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"id": "NzAwNTUxOTA5NzczMTQ4MTYw",
"name": "text",
"type": "NORMAL",
"format": "CSV",
"completed_at": "2017-07-21T17:32:28Z",
"file_name": "text",
"file_size": 0,
"file_url": "/api/blobs/WexWdABcd5D4PDgzTKV3gAAAEu00WcK"
}
Destroy completed call report by it's unique ID.
The unique ID of this call report.
The unique ID of the resource.
NzAwNTUxOTA5NzczMTQ4MTYw
POST /api/completed_call_reports/{id}/destroy HTTP/1.1
Host: hostname:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content