Get Click-to-Dial History
Click to Call
Get Click-to-Dial History
GET
Get Click-to-Dial History
Retrieve the click-to-dial call history for your workspace, ordered by most recent first. Each entry includes a link to the call recording once the call has completed and the recording has been processed.
API Endpoint
GET/api/v1/global/click-to-dial/history
Content-Type: application/json
Authentication: Required (Token header: token or api_access_token)
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
app_id | integer | No | Return only calls triggered with this app_id |
page | integer | No | Page number, starting at 1. Defaults to 1 |
limit | integer | No | Number of records per page. Defaults to 20 |
Success Response
Status Code:200 OK
Response Fields
Call History Entry
| Field | Type | Description |
|---|---|---|
call_id | string | Unique identifier of the call, matching the call_id returned by the trigger endpoint |
created_date | string | Timestamp when the call was triggered (YYYY-MM-DD HH:mm:ss) |
recording | string | null | URL of the call recording, or null if not yet available |
caller_number | string | The agent’s own phone number (user_number at trigger time) |
callee_number | string | The customer number that was dialled (client_number at trigger time) |
display_number | string | The DID shown to the customer as the caller ID (did_number at trigger time) |
Pagination
| Field | Type | Description |
|---|---|---|
page | integer | Current page number |
limit | integer | Records per page |
total | integer | Total number of call records |
total_pages | integer | Total number of pages |
Error Responses
All errors are returned in a common envelope. Always check theerror field of the response body.
401 Unauthorized
Example Requests
Get call history (paginated)
Filter by app
Important Notes
Call Recordings
- The
recordingfield isnullwhile a call is still in progress or if no recording was captured - Poll this endpoint after the call ends to fetch the recording URL
Pagination
- Results are ordered by most recent first
- Use
pageandlimitto page through results;pagination.total_pagestells you how many pages are available

