Saltar al contenido principal
GET
Returns a paginated list of your organization’s calls, newest first by default. Each call includes its transcript (chat_history), its analysis and its contact. The only filter is phoneNumber, which narrows the list to one contact. This endpoint does not filter by date, status, result, agent or campaign: any query parameter not listed below is rejected with 400.
This endpoint requires your organization’s API key. A personal API key gets 403 Forbidden.

Headers

string
requerido
Your organization’s API key. Found in your dashboard under API settings.

Query Parameters

number
predeterminado:"5"
Maximum number of calls to return, up to 1000. If omitted or 0, returns 5.
number
predeterminado:"0"
Number of calls to skip for pagination. Must be ≥ 0.
string
predeterminado:"desc"
Sort direction by creation date. Possible values: asc, desc (lowercase).
string
Phone number in E.164 format (e.g. +12124567890). Returns only the calls of the contact in your organization that has this phone number. It does not match the number a call was placed from or to.

Response

The response contains statusCode, a data array, and pagination.
array
Array of call objects.
object
Pagination metadata: page (current page, counting from 1, given limit and offset), total_rows and total_pages.

Error Codes

  • 400 Bad Request — Invalid query parameters: an unknown parameter (property <name> should not exist), limit above 1000, an order other than asc/desc, or a phoneNumber that is not a valid number. Today it is also returned when phoneNumber does not match any contact in your organization.
  • 401 Unauthorized — Invalid or missing API key
  • 403 Forbidden — The key is a personal API key; use your organization’s API key
  • 429 Too Many Requests — Rate limit exceeded; honor Retry-After when present and use bounded backoff. See Rate Limits
  • 500 Internal Server Error — Server-side error

Code Examples