Sign in

v2

latestOpenAPI 3.1.02026-08-07750280.6 KB
Call History

List call history

Retrieve a paginated list of call history records for the authenticated organization.

Polling integrations (e.g. Zapier): to avoid missing calls during high-volume windows, poll with sort=-created_at&created_after=<bookmark>, where <bookmark> is the highest created_at value seen in the previous batch. Results are returned in created_at DESC, id DESC order by default, so pagination is deterministic.

get/call-history

Query parameters

limitinteger

Maximum number of call records to return

Maximum number of call records to return

offsetinteger

Number of call records to skip for pagination

Number of call records to skip for pagination

sortstring nullable

Sort field. Prefix with '-' for descending order. Available: start_time, end_time, duration, created_at

Sort field. Prefix with '-' for descending order. Available: start_time, end_time, duration, created_at

call_statusstring nullable

Filter by call status. Accepted values: Completed, Not Answered, Rejected, Failed, Busy, Voicemail, Ended In Queue

Filter by call status. Accepted values: Completed, Not Answered, Rejected, Failed, Busy, Voicemail, Ended In Queue

is_outboundboolean nullable

Filter by call direction (true for outbound, false for inbound)

Filter by call direction (true for outbound, false for inbound)

from_numberstring nullable

Filter by caller phone number

Filter by caller phone number

to_numberstring nullable

Filter by called phone number

Filter by called phone number

phone_numberstring nullable

Filter by any phone number (from_number or to_number)

Filter by any phone number (from_number or to_number)

contact_idstring uuid nullable

Filter by contact ID

Filter by contact ID

created_afterstring date-time nullable

Return only calls created strictly after this ISO-8601 timestamp. Intended for polling integrations: bookmark the highest created_at from the previous response and pass it back on the next request to fetch only new calls.

Return only calls created strictly after this ISO-8601 timestamp. Intended for polling integrations: bookmark the highest created_at from the previous response and pass it back on the next request to fetch only new calls.

Response

Successfully retrieved call history

okboolean