Calls

List calls (paginated with filters)

GET
/api/v1/calls

Authorization

tenant-api-key
x-api-key<token>

Tenant API key (backend only — never expose to a browser)

In: header

Query Parameters

page?number
Range1 <= value
Default1
limit?number
Range1 <= value <= 100
Default20
status?string

Filter by call status

Value in

  • "QUEUED"
  • "RINGING"
  • "CONNECTING"
  • "CONNECTED"
  • "ON_HOLD"
  • "FORWARDING"
  • "MISSED"
  • "CANCELLED"
  • "COMPLETED"
  • "FAILED"
queueName?string

Filter by queue name

callerExternalId?string

Filter by caller external ID

targetExternalId?string

Filter by target external ID

acceptedByExternalId?string

Filter by agent who accepted

priority?number

Minimum priority filter (gte)

Response Body

curl -X GET "https://example.com/api/v1/calls"
Empty