Call Detail Records
Export CDRs as CSV
Export Vobiz call detail records as a CSV file for billing reconciliation, compliance auditing, and traffic analysis - returns text/csv content directly.
GET
/
api
/
v1
/
Account
/
{auth_id}
/
cdr
/
export
Export CDRs as CSV
curl --request GET \
--url https://api.vobiz.ai/api/v1/Account/{auth_id}/cdr/export \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>'import requests
url = "https://api.vobiz.ai/api/v1/Account/{auth_id}/cdr/export"
headers = {
"X-Auth-ID": "<api-key>",
"X-Auth-Token": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/Account/{auth_id}/cdr/export', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<string>The export endpoint returns
text/csv content. Do not send Accept: application/json on this request - pipe the response directly to a file with curl -o cdrs.csv.Filters
Export accepts the same filters as the list endpoint, minus paging. There is nopage or per_page; the file contains every matching row.
| Parameter | Type | Notes |
|---|---|---|
from_number | string | Originating (caller) number. Substring or full E.164. |
to_number | string | Destination (callee) number. |
start_date | string YYYY-MM-DD | Required together with end_date. |
end_date | string YYYY-MM-DD | Required together with start_date. |
call_direction | enum | inbound or outbound. |
min_duration | integer | Seconds; excludes shorter calls. |
Because there is no paging, always scope the export with
start_date/end_date (and any other filter) to keep the file size manageable for high-volume accounts.Response
- Content type is
text/csv. The columns mirror the CDR object fields (see the field glossary). - An empty match still returns
200with a header-only (or empty) CSV body - not a404.
Example
cURL
curl -G "https://api.vobiz.ai/api/v1/Account/{auth_id}/cdr/export" \
--data-urlencode "start_date=2026-03-01" \
--data-urlencode "end_date=2026-03-17" \
--data-urlencode "call_direction=outbound" \
-H "X-Auth-ID: {auth_id}" \
-H "X-Auth-Token: {auth_token}" \
-o cdrs.csv
To receive a large recordings archive by email instead of a synchronous CSV, see Export Historical Recordings. For per-call JSON, use List CDRs.
Authorizations
Query Parameters
Response
CSV file containing CDR rows
The response is of type file.
Was this page helpful?
⌘I
Export CDRs as CSV
curl --request GET \
--url https://api.vobiz.ai/api/v1/Account/{auth_id}/cdr/export \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>'import requests
url = "https://api.vobiz.ai/api/v1/Account/{auth_id}/cdr/export"
headers = {
"X-Auth-ID": "<api-key>",
"X-Auth-Token": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/Account/{auth_id}/cdr/export', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<string>