Skip to main content
GET
List Calls

Overview

This endpoint retrieves a list of calls associated with the authenticated user’s assistants. You can filter calls by date range, status, and playbook.

Authentication

This endpoint requires authentication using a Bearer token in the Authorization header.

Query Parameters

string
Start date for filtering calls. Format: YYYY-MM-DD or YYYY-MM-DD HH:mm:ssIf not provided, it will be calculated based on daysFromNow parameter.
string
End date for filtering calls. Format: YYYY-MM-DD or YYYY-MM-DD HH:mm:ssIf not provided, it will default to the current date/time.
number
default:"15"
Number of days to look back from today. Only used if startDate and endDate are not provided.
  • Minimum: 1
  • Maximum: 90
  • Default: 15
string
Filter calls by status. Valid values:
  • open - Call is in progress or pending
  • closed - Call has been completed successfully
  • rong-phone-forno-answer - Wrong phone number or no answer
  • wmat - Waiting for manual action
  • failed - Call failed
  • recall-scheduled - A recall has been scheduled
  • voicemail - Call went to voicemail
string
Filter calls by a specific playbook (assistant) ID. Must be a valid UUID.

Response

array
Array of call objects, ordered by created_time descending (most recent first).

Example Requests

Get calls from the last 30 days

Get calls within a specific date range

Get only closed calls

Get calls for a specific playbook

Combine filters

Example Response

Error Responses

object
Authentication failed or token is invalid
object
User does not have permission to access this resource
object
An error occurred on the server

Notes

  • All dates are handled in Europe/Madrid timezone and converted to UTC in the response
  • The from field is automatically sanitized to remove invalid entries like “phoneNumber.phoneNumber”
  • Transcripts are formatted with HTML tags for better readability in UI applications
  • The endpoint automatically filters calls to only show those belonging to assistants owned by the authenticated user
  • Maximum date range when using daysFromNow is 90 days