Skip to main content
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

Success Response

Status Code: 200 OK

Response Fields

Call History Entry

Pagination

Error Responses

All errors are returned in a common envelope. Always check the error field of the response body.

401 Unauthorized

Example Requests

Get call history (paginated)

Filter by app

Important Notes

Call Recordings

  • The recording field is null while 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 page and limit to page through results; pagination.total_pages tells you how many pages are available

Headers

token
string
required

API token for authentication

Query Parameters

app_id
integer

Return only calls triggered with this app_id

page
integer
default:1

Page number, starting at 1

limit
integer
default:20

Number of records per page

Response

Call history retrieved successfully

data
object[]
pagination
object