Skip to main content
GET
List Calls

Overview

Returns one page of calls for a single agent owned by the authenticated account. The body is a JSON object. calls is ordered by created_time descending (most recent first). page and total_pages are strings. agent_id is required. A request without it does not list every agent on the account.

Authentication

Query Parameters

string
required
UUID of the agent whose calls you want. The agent must belong to the authenticated account. assistant_id is accepted as the same field. If both are sent, they must be equal.
number
default:"1"
1-based page number.
  • Minimum: 1
  • Maximum: 1000
number
default:"50"
Calls per page.
  • Minimum: 1
  • Maximum: 100
  • Default: 50
string
Start of the window, interpreted as UTC. Format: YYYY-MM-DD or YYYY-MM-DD HH:mm:ss. A timezone suffix such as Z or +02:00 is accepted and converted to UTC.Must be sent together with endDate.
string
End of the window, inclusive, interpreted as UTC. Same formats as startDate.A date-only value (2026-10-29) includes that whole UTC day, through 23:59:59. Must be sent together with startDate. The span cannot exceed 90 days.
number
default:"15"
How many days back from now (UTC) to include. Used only when startDate and endDate are omitted.
  • Minimum: 1
  • Maximum: 90
  • Default: 15
An invalid value returns 400. It is not replaced with the default.
string
Filter by call status. Omit it and the query still returns only calls in busy, closed, no-answer, silence-call, voicemail, and failed.One value, a comma-separated list, or the parameter repeated:status=closedstatus=closed,voicemailstatus=closed&status=voicemailAllowed values: busy, closed, no-answer, silence-call, voicemail, failed.Any other value returns 400. It is not ignored.

Response

string
UUID of the agent this page belongs to.
string
Name of that agent.
string
The page you requested, starting at "1".
string
ceil(matching calls / limit), as a string. "0" when the filter matches nothing.A page past the end still returns this object with calls as an empty array.
array
Call objects for this page.

Example Requests

First page

Next page

Repeat the same filters and send the next page number. Nothing is cached between requests. page comes back inside the JSON.

Date range, status, and page size

endDate=2026-10-29 includes that entire UTC day.

Example Response

Error Responses

object
Missing or invalid agent_id, an invalid date or status, a range longer than 90 days, or a page / limit outside its bounds.
object
Missing or invalid token.
object
The agent does not exist on this account.
string

Notes

  • Dates are UTC. A value without a timezone is not read as Europe/Madrid.
  • from is cleared when the stored value is the placeholder phoneNumber.phoneNumber.
  • Each request reads the database again. page=2 skips the first limit matching calls.
  • The account id is not a valid agent_id. Send the id of one agent.