---
title: "List AI phone agents"
method: GET
path: "/phone"
---

# List AI phone agents

`GET /phone`

List all AI phone agents in your organization with full details including name, type, model, voice, language, phone number, and configuration.

## Response `200`

Default Response

- PhoneAgentDto[]
  - `id` string, required
  - `org_id` string, required
  - `phone_number` string, nullable, required
  - `name` string, nullable, required
  - `type` 'inbound' | 'outbound', required
  - `language` string[], required
  - `accent` string, nullable, required
  - `handoff_phone_number` string, nullable, required
  - `speed` number, nullable, required
  - `interruptible` boolean, required
  - `actionIds` string[], nullable, required
  - `instructions` string[], nullable, required
  - `data_collection_fields` string[], nullable, required
  - `data_collection_webhook_url` string, nullable, required
  - `model` 'oppie-vox' | 'oppie-vox-turbo' | 'oppie-vox-2' | 'oppie-vox-livekit', required
  - `voice_id` string, nullable, required
  - `first_message` string, nullable, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `provider_external_id` string, nullable, required
  - `flow` unknown, required
  - `custom_llm` string, nullable, required
  - `use_org_knowledgebase` boolean, required
  - `background_noise_preset` 'office' | 'bar' | 'city-street', nullable, required
  - `recording_enabled` boolean, required
  - `stt_keyterms` string[], required
  - `stt_model` 'deepgram/flux-general' | 'deepgram/nova-3' | 'deepgram/nova-3-medical' | 'cartesia/ink-whisper' | 'elevenlabs/scribe_v2_realtime' | 'xai/stt-1' | 'assemblyai/universal-3-5-pro' | 'speechmatics/enhanced', nullable, required
  - `tts_speed_pct` integer, nullable, required
  - `failover_transfer_destination_id` string, uuid, nullable, required

## Other responses

- `500` — Internal Server Error

---

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