List Calls
Endpoints
List Calls
Retrieve a list of calls with filtering options
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 pendingclosed- Call has been completed successfullyrong-phone-forno-answer- Wrong phone number or no answerwmat- Waiting for manual actionfailed- Call failedrecall-scheduled- A recall has been scheduledvoicemail- 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
fromfield 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
daysFromNowis 90 days

