List calls for a tenant
/org/{tenant_code}/v2/calls
Platform support: MT and CC
Lists the currently live calls, regardless of how they were initiated (API or device).
Each entry mirrors the real-time event_call_* event payload (plus tenant_code), so this
list can be used as a snapshot and reconciled against the event stream by uid.
Authentication modes:
- User token: Returns only the calls of the authenticated extension.
- API key / service: Returns all calls for the tenant in the URL. On a non-multi-tenant
deployment use
/org/default/v2/calls, which returns all calls.
On a multi-tenant deployment a tenant code that cannot be resolved from the URL (e.g.
default or a non-numeric value) yields 400 Bad Request. A user token without an
associated extension yields 401 Unauthorized.
Request
Responses
- 200
- 400
- 401
- 404
- 500
- 504
List of active calls
Invalid request body or missing required fields
Missing or malformed user identity
The requested resource or scope is not available. Returned, for example, when the system scope is used on a non-multi-tenant deployment, or with a non-API-key identity.
Internal server error
The proxy timed out waiting for the processing thread to service the request. For call initiation the call may still proceed on the PBX; for a list request no state is changed. The timeout only bounds how long the request is held open.