---
title: "Gets a list of ai calls"
method: GET
path: "/aicalls"
tags: ["AI"]
---

# Gets a list of ai calls

`GET /aicalls`

Retrieves a paginated list of ai calls based on the provided query parameters.

## Query parameters

- `page_size` integer
- `page_token` string

## Response `200`

A list of ai calls.

- object
  - `next_page_token` string — Cursor token for the next page of results. Pass this value as the page_token parameter in the next request.
  - `result` AIManagerAIcall[]
    - `id` string, uuid — The unique identifier of the AI call.
    - `customer_id` string, uuid — The unique identifier of the associated customer. Returned from the `GET /customers` response.
    - `assistance_type` '' | 'ai' | 'team' — Type of assistance entity associated with the AI call.
    - `assistance_id` string, uuid — The unique identifier of the assistance entity (AI or Team). Returned from the `POST /ais`, `GET /ais`, `POST /teams`, or `GET /teams` response.
    - `ai_engine_model` 'gemini.gemini-2.5-flash' | 'gemini.gemini-2.5-pro' | 'gemini.gemini-2.0-flash' | 'gemini.gemini-pro-latest' | 'openai.gpt-5.2' | 'openai.gpt-5.1' | 'openai.gpt-5' | 'openai.gpt-5-mini' | 'openai.gpt-5-nano' | 'grok.grok-3' | 'grok.grok-3-mini' — Model of the AI engine. Uses target.model format (e.g., openai.gpt-5). The target prefix identifies the provider, and the model name follows after the dot.
    - `ai_tts_type` '' | 'async' | 'aws' | 'azure' | 'cartesia' | 'deepgram' | 'elevenlabs' | 'fish' | 'google' | 'groq' | 'hume' | 'inworld' | 'lmnt' | 'minimax' | 'neuphonic' | 'nvidia-riva' | 'openai' | 'piper' | 'playht' | 'rime' | 'sarvam' | 'xtts' — Text-to-speech provider type.
    - `ai_tts_voice_id` string — Text-to-speech voice identifier used for this call.
    - `ai_stt_type` '' | 'cartesia' | 'deepgram' | 'elevenlabs' — Speech-to-text provider type.
    - `ai_vad_config` AIManagerVADConfig — Voice Activity Detection configuration. Omitted fields use Pipecat defaults (confidence=0.7, start_secs=0.2, stop_secs=0.2, min_volume=0.6).
      - `confidence` number, double — Minimum confidence threshold to detect voice. Range 0.0–1.0. Omitted fields use Pipecat default.
      - `start_secs` number, double — Duration in seconds of continuous speech needed to confirm speaking started. Range 0.0–30.0. Omitted fields use Pipecat default.
      - `stop_secs` number, double — Duration in seconds of silence needed to confirm speaking stopped. Range 0.0–30.0. Omitted fields use Pipecat default.
      - `min_volume` number, double — Minimum audio volume for voice detection. Range 0.0–1.0. Omitted fields use Pipecat default.
    - `ai_smart_turn_enabled` boolean — Smart turn detection setting frozen from the AI configuration at call start.
    - `parameter` object — Merged key-value parameter data from AI and team configuration.
    - `activeflow_id` string, uuid — The unique identifier of the activeflow. Returned from the `GET /activeflows` response.
    - `reference_type` '' | 'call' | 'conversation' | 'task' | 'contact_case' — Type of reference associated with the ai call.
    - `reference_id` string, uuid — The unique identifier of the referenced resource. The actual resource type is determined by reference_type. Returned from the corresponding resource endpoint.
    - `confbridge_id` string, uuid — The unique identifier of the conference bridge. Returned from the `GET /conferences` response.
    - `current_member_id` string, uuid — The unique identifier of the currently active team member. Only set when assistance_type is 'team'. Updated when the AI agent transitions to a different team member.
    - `status` 'initiating' | 'progressing' | 'pausing' | 'resuming' | 'terminating' | 'terminated' — Status of the ai call.
    - `stt_language` string — STT language copied from AI config at creation time.
    - `metadata` object — Generic key-value store. Contains prompt_snapshots (array of PromptSnapshot) at call start time.
    - `tm_end` string, date-time — Timestamp when the AI call ended.
    - `tm_create` string, date-time — Timestamp when the AI call was created.
    - `tm_update` string, date-time — Timestamp when the AI call was last updated.
    - `tm_delete` string, date-time — Timestamp when the AI call was deleted.

## Other responses

- `401` — Authentication required (UNAUTHENTICATED).
- `500` — Internal error (INTERNAL).

---

[API](https://skmtc.net/voipbin/apis/voipbin-api.md) · [All operations](https://skmtc.net/voipbin/apis/voipbin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voipbin/voipbin-api/versions/79e779080bcc/schema)