Chat icon

Chat

Interact with the Chat API

Actions253

Call History → List

AI-generated

Summary

List call history records for a selected account with optional filters, pagination, and status.

Inputs

  • accountId (required) — Select the account whose call history to retrieve.
  • filters — Apply filter criteria such as date range, direction, and inbox.
  • date_from — Start of the date range for filtering calls.
  • date_to — End of the date range for filtering calls.
  • direction — Filter calls by direction (all, inbound, or outbound).
  • inboxId — Limit results to a specific inbox.
  • page — Page number for paginated results (minimum 1).
  • status — Filter calls by status (e.g., completed, failed).

Output shape

a list of call history records

Pagination is controlled via the page parameter; results may include additional metadata such as total count. The response body is an array of call history items.

Examples

Example 1: Retrieve outbound calls for an account within a specific date range

accountId=12345, filters.date_from=2024-01-01, filters.date_to=2024-01-31, filters.direction=outbound, page=1

Example 2: List inbound calls from a particular inbox

accountId=12345, inboxId=6789, filters.direction=inbound, page=2

Example 3: Get recent completed calls, paginated

accountId=12345, status=completed, page=3

Links

Discussion