---
title: "Read one owned agent's active native calls across all engine nodes"
method: GET
path: "/v1/calls/active"
---

# Read one owned agent's active native calls across all engine nodes

`GET /v1/calls/active`

## Request

- Base URL: `https://volai.cz`
- URL: `https://volai.cz/v1/calls/active`
- Auth: HTTP bearer

Reads every configured native engine node for one owned `agentId`. This is a live snapshot, unlike call history. `complete` means all engine responses were valid and ownership metadata was complete. `outboundCount` includes unresolved calls; `inboundCount` counts callbacks separately. Every outbound row has an opaque `nativeRef`, `startedAt` (Unix ms) and `resolved`. Only verified task calls include `callId`, `taskId`, `itemId` and `phoneSha256`. A missing mapping remains visible with `resolved: false`. `checkedAt` is the ISO snapshot completion time and `enginesChecked` the node count. Prove no outbound calls only when `complete: true`, `outboundCount: 0` and `unresolvedOutboundCount: 0`; errors or an incomplete snapshot never prove zero. This endpoint covers native phone calls only, not web sessions or other providers. Uses the existing shared API key rate limit.

## Query parameters

- `agentId` string, required

## Response `200`

Verified engine snapshot

- object
  - `data` object, required
    - `agentId` string, required
    - `complete` boolean, required
    - `checkedAt` string, date-time, required
    - `enginesChecked` integer, required
    - `outboundCount` integer, required
    - `inboundCount` integer, required
    - `unresolvedOutboundCount` integer, required
    - `outbound` object[], required
      - `nativeRef` string, required
      - `startedAt` number, required
      - `callId` string
      - `taskId` string
      - `itemId` string
      - `phoneSha256` string
      - `resolved` boolean, required

## Other responses

- `400`: Error codes: validation (request).
- `401`: Error codes: unauthorized (request).
- `403`: Error codes: account_suspended (account).
- `404`: Error codes: agent_not_found (account).
- `429`: Error codes: rate_limited (busy).
- `500`: Error codes: internal_error (service).
- `502`: Error codes: engine_unavailable (service).
- `503`: Error codes: engine_not_configured (service).

---

[API](https://skmtc.dev/volai/apis/volai-rest-api.md) · [All operations](https://skmtc.dev/volai/apis/volai-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volai/apis/volai-rest-api/revisions/12029b05e2fa?raw)