List recent calls
Returns a rolling in-memory history of recent calls for the authenticated device (most recent first).
Returns a rolling in-memory history of recent calls for the authenticated device (most recent first).
Authorization
bearerAuth 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/history"{ "success": true, "calls": [ { "device_id": "dev_abc123", "call_id": "73EE9BC6A87B1AA5AED857F4DBB73B0E", "peer": "83034753732714@lid", "direction": "outbound", "status": "ended", "is_video": false, "started_at": 0, "ended_at": 1784237437228, "reason": "user_ended" } ], "timestamp": "2026-07-16T18:36:01Z"}{ "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"}List active calls GET
Returns the calls currently ringing or connected for the authenticated device.
Mint a media socket token POST
Mints a **single-use, 90-second** token for opening the WSS media socket of a specific call. This exists because a browser cannot set the Authorization header on a WebSocket handshake and the company bearer must never appear in a URL. Open `ws_url` immediately after minting.