PrivacidadeTermos
Calls

List active calls

Returns the calls currently ringing or connected for the authenticated device.

GET
/calls/active

Returns the calls currently ringing or connected for the authenticated device.

Authorization

bearerAuth
AuthorizationBearer <token>

Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.

In: header

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/calls/active"
{  "success": true,  "calls": [    {      "device_id": "dev_abc123",      "call_id": "9D31414B80C630FFB44FCB5261FF9AE2",      "peer": "83034753732714@lid",      "direction": "outbound",      "status": "connected",      "is_video": false,      "started_at": 0    }  ],  "timestamp": "2026-07-16T18:30:37Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}

Accept an incoming call POST

Accepts a ringing **inbound** call for the authenticated device and brings up the media path. Provide the call_id from the `call.offer` webhook. Answering with live audio also requires opening the WSS media socket.

List recent calls GET

Returns a rolling in-memory history of recent calls for the authenticated device (most recent first).