Skip to main content
GET
/
api
/
v1
/
partner
/
accounts
/
{customer_auth_id}
/
cdrs
List customer CDRs
curl --request GET \
  --url https://api.vobiz.ai/api/v1/partner/accounts/{customer_auth_id}/cdrs \
  --header 'X-Auth-ID: <api-key>' \
  --header 'X-Auth-Token: <api-key>'
{
  "success": true,
  "account_id": "MA_XXXXXXXX",
  "account_auth_id": "MA_XXXXXXXX",
  "count": 2,
  "data": [
    {
      "account_id": "MA_XXXXXXXX",
      "answer_time": "2026-03-25T06:59:31Z",
      "billsec": 1,
      "bridge_uuid": "aabbccdd-1234-5678-90ab-cdef12345678",
      "call_direction": "outbound",
      "caller_id_name": "Acme Corp",
      "caller_id_number": "+918012345678",
      "campaign_id": null,
      "carrier_ip": null,
      "codec": "PCMU",
      "context": "voice-api",
      "cost": 0.3,
      "created_at": "2026-03-25T06:59:32Z",
      "currency": "INR",
      "customer_endpoint": null,
      "destination_number": "+919876543210",
      "duration": 6,
      "end_time": "2026-03-25T06:59:32Z",
      "failure_code": null,
      "failure_reason": null,
      "hangup_cause": "NORMAL_CLEARING",
      "hangup_cause_code": 4000,
      "hangup_cause_name": "Normal Hangup",
      "hangup_disposition": "send_bye",
      "hangup_source": "Caller",
      "id": 18600001,
      "jitter": 0,
      "mos": 4.5,
      "network_addr": "3.110.99.6",
      "origination_region": "mumbai",
      "packet_loss": 0,
      "progress_time": "2026-03-25T06:59:26Z",
      "region": "ap-south-1",
      "ring_time": 5,
      "sip_call_id": "11223344-1234-5678-90ab-cdef12345678",
      "sip_user_agent": "Vobiz",
      "start_time": "2026-03-25T06:59:26Z",
      "streaming_cost": 0,
      "terminated_to": null,
      "total_cost": 0.3,
      "trunk_id": null,
      "updated_at": "2026-03-25T06:59:32Z",
      "uuid": "55667788-1234-5678-90ab-cdef12345678"
    },
    {
      "account_id": "MA_XXXXXXXX",
      "answer_time": "2026-03-25T07:10:11Z",
      "billsec": 4,
      "bridge_uuid": "99887766-1234-5678-90ab-cdef12345678",
      "call_direction": "inbound",
      "caller_id_name": "+919876543210",
      "caller_id_number": "+919876543210",
      "campaign_id": null,
      "carrier_ip": null,
      "codec": "PCMU",
      "context": "voice-api",
      "cost": 0.45,
      "created_at": "2026-03-25T07:10:15Z",
      "currency": "INR",
      "customer_endpoint": null,
      "destination_number": "+918012345678",
      "duration": 9,
      "end_time": "2026-03-25T07:10:15Z",
      "failure_code": null,
      "failure_reason": null,
      "hangup_cause": "NORMAL_CLEARING",
      "hangup_cause_code": 4010,
      "hangup_cause_name": "End Of XML Instructions",
      "hangup_disposition": "send_bye",
      "hangup_source": "Vobiz",
      "id": 18600002,
      "jitter": 0,
      "mos": 4.5,
      "network_addr": "13.203.7.132",
      "origination_region": "mumbai",
      "packet_loss": 0,
      "progress_time": "2026-03-25T07:10:06Z",
      "region": "ap-south-1",
      "ring_time": 5,
      "sip_call_id": "aabbccdd-1234-5678-90ab-cdef12345678",
      "sip_user_agent": "Vobiz",
      "start_time": "2026-03-25T07:10:06Z",
      "streaming_cost": 0,
      "terminated_to": null,
      "total_cost": 0.45,
      "trunk_id": null,
      "updated_at": "2026-03-25T07:10:15Z",
      "uuid": "aabbccdd-9999-5678-90ab-cdef12345678"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 2,
    "pages": 1,
    "has_next": false,
    "has_prev": false
  },
  "summary": {
    "answerRate": 100,
    "answeredCalls": 2,
    "avgCallDuration": "7s",
    "last_call_at": "2026-03-25T07:10:15Z",
    "totalCalls": 2,
    "total_billable_seconds": 15,
    "total_cost": 1,
    "total_duration_seconds": 15
  }
}
← Partner API Reference Full call detail records for every voice session across your partner ecosystem. Filter by date range, direction, hangup cause, number, and more. Essential for billing reconciliation, call quality troubleshooting, and traffic monitoring.
All Partner API requests use X-Auth-ID and X-Auth-Token headers. See Authentication for details.

​
Overview

The CDR API gives you read access to call logs for all customers under your partner account. Three endpoints cover different scopes:
  • Customer CDRs - Filtered CDR log for one customer. Most common - use for per-customer billing and support tickets.
  • Single CDR by UUID - Deep forensic detail for one specific call by its UUID. Use for troubleshooting a specific incident.
  • All CDRs (Global) - Global traffic log across all accounts. Use for platform-wide quality monitoring and aggregate reporting.

​
Customer CDRs

Returns a paginated CDR log for one specific customer. All filter parameters are optional - omit all to get the most recent calls paginated by default.

​
Available Filters

ParameterTypeExampleDescription
pageinteger1Page number (1-indexed)
per_pageinteger20Items per page (max 100)
start_datestring2026-03-01Start of date range, YYYY-MM-DD
end_datestring2026-03-31End of date range, YYYY-MM-DD
call_directionstringinboundinbound or outbound
statusstringansweredanswered, failed, busy, no_answer
hangup_causestringNO_ANSWERSIP/Q.850 hangup cause, e.g. NORMAL_CLEARING, NO_ANSWER, USER_BUSY
min_durationinteger10Minimum call duration in seconds
The date filters here are start_date / end_date (CDRs), not from_date / to_date as used by the Transactions endpoint. Status values are underscored: no_answer, not no-answer.

​
Examples

curl -X GET \
  "https://api.vobiz.ai/api/v1/partner/accounts/{customer_auth_id}/cdrs?page=1&per_page=20" \
  -H "X-Auth-ID: {your_partner_id}" \
  -H "X-Auth-Token: {your_auth_token}" \
  -H "Accept: application/json"

curl -X GET \
  "https://api.vobiz.ai/api/v1/partner/accounts/{customer_auth_id}/cdrs?start_date=2026-03-01&end_date=2026-03-31&per_page=100" \
  -H "X-Auth-ID: {your_partner_id}" \
  -H "X-Auth-Token: {your_auth_token}" \
  -H "Accept: application/json"

curl -X GET \
  "https://api.vobiz.ai/api/v1/partner/accounts/{customer_auth_id}/cdrs?call_direction=inbound&status=answered&min_duration=10&start_date=2026-03-01&end_date=2026-03-31" \
  -H "X-Auth-ID: {your_partner_id}" \
  -H "X-Auth-Token: {your_auth_token}" \
  -H "Accept: application/json"

curl -X GET \
  "https://api.vobiz.ai/api/v1/partner/accounts/{customer_auth_id}/cdrs?status=failed&hangup_cause=NO_ANSWER&start_date=2026-03-20" \
  -H "X-Auth-ID: {your_partner_id}" \
  -H "X-Auth-Token: {your_auth_token}" \
  -H "Accept: application/json"

​
Response

{
  "success": true,
  "account_id": "MA_XXXXXXXX",
  "account_auth_id": "MA_XXXXXXXX",
  "count": 2,
  "data": [
    {
      "account_id": "MA_XXXXXXXX",
      "answer_time": "2026-03-25T10:00:08Z",
      "billsec": 177,
      "bridge_uuid": "aabbccdd-1234-5678-90ab-cdef12345678",
      "call_direction": "outbound",
      "caller_id_name": "John Doe",
      "caller_id_number": "+919876543210",
      "campaign_id": null,
      "carrier_ip": "10.0.0.1",
      "codec": "PCMU",
      "context": "voice-api",
      "cost": 0.45,
      "created_at": "2026-03-25T10:03:05Z",
      "currency": "INR",
      "customer_endpoint": null,
      "destination_number": "+918012345678",
      "duration": 185,
      "end_time": "2026-03-25T10:03:05Z",
      "failure_code": null,
      "failure_reason": null,
      "hangup_cause": "NORMAL_CLEARING",
      "hangup_cause_code": 4000,
      "hangup_cause_name": "Normal Hangup",
      "hangup_disposition": "send_bye",
      "hangup_source": "Caller",
      "id": 18000000,
      "jitter": 2,
      "mos": 4.5,
      "network_addr": "10.0.0.2",
      "origination_region": "mumbai",
      "packet_loss": 0,
      "progress_time": "2026-03-25T10:00:00Z",
      "region": "ap-south-1",
      "ring_time": 8,
      "sip_call_id": "aabbccdd-1234-5678-90ab-cdef12345678",
      "sip_user_agent": "Vobiz",
      "start_time": "2026-03-25T10:00:00Z",
      "streaming_cost": 0,
      "terminated_to": null,
      "total_cost": 0.45,
      "trunk_id": null,
      "updated_at": "2026-03-25T10:03:05Z",
      "uuid": "aabbccdd-1234-5678-90ab-cdef12345678"
    },
    {
      "account_id": "MA_XXXXXXXX",
      "answer_time": "2026-03-25T11:15:04Z",
      "billsec": 42,
      "bridge_uuid": "11223344-5566-7788-99aa-bbccddeeff00",
      "call_direction": "outbound",
      "caller_id_name": "",
      "caller_id_number": "+919876543210",
      "campaign_id": null,
      "carrier_ip": "10.0.0.1",
      "codec": "PCMU",
      "context": "voice-api",
      "cost": 0.12,
      "created_at": "2026-03-25T11:15:46Z",
      "currency": "INR",
      "customer_endpoint": null,
      "destination_number": "+918012345678",
      "duration": 46,
      "end_time": "2026-03-25T11:15:46Z",
      "failure_code": null,
      "failure_reason": null,
      "hangup_cause": "NORMAL_CLEARING",
      "hangup_cause_code": 4000,
      "hangup_cause_name": "Normal Hangup",
      "hangup_disposition": "send_bye",
      "hangup_source": "Callee",
      "id": 18000001,
      "jitter": 1,
      "mos": 4.4,
      "network_addr": "10.0.0.2",
      "origination_region": "mumbai",
      "packet_loss": 0,
      "progress_time": "2026-03-25T11:15:00Z",
      "region": "ap-south-1",
      "ring_time": 4,
      "sip_call_id": "11223344-5566-7788-99aa-bbccddeeff00",
      "sip_user_agent": "Vobiz",
      "start_time": "2026-03-25T11:15:00Z",
      "streaming_cost": 0,
      "terminated_to": null,
      "total_cost": 0.12,
      "trunk_id": null,
      "updated_at": "2026-03-25T11:15:46Z",
      "uuid": "11223344-5566-7788-99aa-bbccddeeff00"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 1284,
    "pages": 65,
    "has_next": true,
    "has_prev": false
  },
  "summary": {
    "answerRate": 48.2,
    "answeredCalls": 619,
    "avgCallDuration": "28s",
    "last_call_at": "2026-03-25T11:15:00Z",
    "totalCalls": 1284,
    "total_billable_seconds": 17428,
    "total_cost": 312.85,
    "total_duration_seconds": 35952
  }
}

​
Get Specific CDR by UUID

Returns complete detail for a single call identified by its UUID. Use this when a customer reports a specific call issue - pass the call UUID from their system or from a previous CDR list query. This endpoint exposes the full call metadata, including SIP response codes and media quality indicators where available. 
curl -X GET \
  "https://api.vobiz.ai/api/v1/partner/accounts/{customer_auth_id}/cdrs/abc123-def456-ghi789" \
  -H "X-Auth-ID: {your_partner_id}" \
  -H "X-Auth-Token: {your_auth_token}" \
  -H "Accept: application/json"

{
  "account_id": "MA_XXXXXXXX",
  "answer_time": "2026-03-25T10:00:08Z",
  "billsec": 177,
  "bridge_uuid": "aabbccdd-1234-5678-90ab-cdef12345678",
  "call_direction": "outbound",
  "caller_id_name": "John Doe",
  "caller_id_number": "+919876543210",
  "campaign_id": null,
  "carrier_ip": "10.0.0.1",
  "codec": "PCMU",
  "context": "voice-api",
  "cost": 0.45,
  "created_at": "2026-03-25T10:03:05Z",
  "currency": "INR",
  "customer_endpoint": null,
  "destination_number": "+918012345678",
  "duration": 185,
  "end_time": "2026-03-25T10:03:05Z",
  "failure_code": null,
  "failure_reason": null,
  "hangup_cause": "NORMAL_CLEARING",
  "hangup_cause_code": 4000,
  "hangup_cause_name": "Normal Hangup",
  "hangup_disposition": "send_bye",
  "hangup_source": "Caller",
  "id": 18000000,
  "jitter": 2,
  "mos": 4.5,
  "network_addr": "10.0.0.2",
  "origination_region": "mumbai",
  "packet_loss": 0,
  "progress_time": "2026-03-25T10:00:00Z",
  "region": "ap-south-1",
  "ring_time": 8,
  "sip_call_id": "aabbccdd-1234-5678-90ab-cdef12345678",
  "sip_user_agent": "Vobiz",
  "start_time": "2026-03-25T10:00:00Z",
  "streaming_cost": 0,
  "terminated_to": null,
  "total_cost": 0.45,
  "trunk_id": null,
  "updated_at": "2026-03-25T10:03:05Z",
  "uuid": "aabbccdd-1234-5678-90ab-cdef12345678"
}

​
All CDRs (Global)

Global CDR log across all customer accounts under your partner umbrella, returned as a single paginated response. Supports all the same filter parameters as the per-customer endpoint. Use for platform-wide traffic monitoring and identifying customers with unusual call patterns. 
curl -X GET \
  "https://api.vobiz.ai/api/v1/partner/cdrs?page=1&per_page=50" \
  -H "X-Auth-ID: {your_partner_id}" \
  -H "X-Auth-Token: {your_auth_token}" \
  -H "Accept: application/json"

curl -X GET \
  "https://api.vobiz.ai/api/v1/partner/cdrs?status=failed&start_date=2026-03-25&per_page=100" \
  -H "X-Auth-ID: {your_partner_id}" \
  -H "X-Auth-Token: {your_auth_token}" \
  -H "Accept: application/json"

​
Response shape

The list response wraps the records in a fixed envelope:
FieldNotes
successAlways true on a 200.
account_id / account_auth_idThe customer the CDRs belong to.
countNumber of records in this page’s data array.
data[]The CDR rows. Key per-row fields: uuid, call_direction, caller_id_number, destination_number, duration (total seconds), billsec (billable seconds), cost / total_cost, hangup_cause, mos (call quality), start_time / answer_time / end_time.
paginationpage, per_page, total, pages, has_next, has_prev.
summaryWindow aggregates: totalCalls, answeredCalls, answerRate, avgCallDuration, total_billable_seconds, total_duration_seconds, total_cost, last_call_at.
For billing, multiply each row’s billsec (billable seconds), not raw duration, by your per-minute rate - or simply read summary.total_cost, which Vobiz has already computed at the customer’s pricing tier.

​
Use Cases

  • Per-customer billing - Pull CDRs for a customer for the billing period. Use summary.total_cost for the period total, or sum billsec across rows if you apply your own markup.
  • Call quality troubleshooting - When a customer reports poor call quality, pull the specific CDR by UUID. Check hangup_cause, mos, jitter, and packet_loss for the root cause.
  • No-answer rate monitoring - Filter by status=no_answer over the past 7 days. High no-answer rates indicate number configuration issues or customer routing problems.
  • Fraud detection - Watch for abnormal call volumes or unusual call durations in the global CDR feed. Spikes in short-duration outbound calls can indicate robocalling abuse.

Authorizations

​
X-Auth-ID
string
header
required

Your Vobiz account Auth ID

​
X-Auth-Token
string
header
required

Your Vobiz account Auth Token

Path Parameters

​
customer_auth_id
string
required

Query Parameters

​
start_date
string<date>
​
end_date
string<date>
​
call_direction
enum<string>
Available options:
inbound,
outbound
​
status
enum<string>
Available options:
answered,
failed,
busy,
no_answer
​
min_duration
integer
​
hangup_cause
string
Example:

"NO_ANSWER"

​
per_page
integer
default:20

Response

200 - application/json

Customer CDRs

​
account_id
string
required
​
count
integer
required
​
data
array
required
​
pagination
object
required
​
success
boolean
required
​
summary
object
required
​
account_auth_id
string
required