Call history and xDRs
Read paginated inbound and outbound call detail records for the authorised customer.
GET/v1/calls
Returns paginated call detail records, also called xDRs, for active telephone numbers owned by the customer linked to the API key.
Query parameters
| Name | Required | Purpose |
|---|---|---|
from | No | Start date and time in ISO 8601 format. The default is seven days before to. |
to | No | End date and time in ISO 8601 format. The default is now. |
direction | No | inbound or outbound. |
telephone_number | No | Limit results to one active number. |
page | No | Page number, starting at 1. |
per_page | No | Records per page, from 1 to 100. The default is 50. |
Maximum date range
One request can cover up to 31 days. Use several requests for a longer reporting period.
Example response
{
"success": true,
"data": {
"items": [{
"call_id": "call_16d9e28bb8f19ebd6e242719",
"telephone_number": "+442012345678",
"direction": "outbound",
"from": "+442012345678",
"to": "+34965123456",
"remote_number": "+34965123456",
"started_at": "2026-07-21T10:12:08+00:00",
"answered_at": "2026-07-21T10:12:14+00:00",
"ended_at": "2026-07-21T10:16:02+00:00",
"duration_seconds": 228,
"billable_seconds": 228,
"status": "answered",
"disconnect_reason": "Normal call clearing",
"cost": {"amount": "0.1824", "currency": "EUR"}
}],
"pagination": {"page": 1, "per_page": 50, "returned": 1, "total": 1, "has_more": false, "truncated": false},
"filters": {"from": "2026-07-14T10:20:00+00:00", "to": "2026-07-21T10:20:00+00:00", "direction": null, "telephone_number": null},
"source_total_before_direction_filter": 1
}
}Dates and storage
Request only the date range you need. Store returned records according to your own legal and privacy duties.
1
Get a token
Request a temporary Sandbox bearer token.
2
Prepare the request
Select the endpoint and add a number when required.
3
Run and check
Review the HTTP status, response time and JSON.
Use a bearer token onlyThe page sends the token through the protected documentation proxy to Voyced Sandbox for this request. It is not saved. Reset or leave the page to clear the field.
The documentation proxy accepts approved Sandbox GET requests only. It cannot call Live. It does not place credentials in cookies, browser storage or URLs.