---
title: "List Voice Agents"
method: GET
path: "/v1/voice_agents"
tags: ["Voice Agents"]
---

# List Voice Agents

`GET /v1/voice_agents`

## Request

- Base URL: `https://api.liveavatar.com`
- URL: `https://api.liveavatar.com/v1/voice_agents`
- Auth: API key in header `X-API-KEY`

List voice agents.

`scope` selects which agents are returned:
* `private` (default) — only the agents your space owns.
* `public` — preset agents owned by no space. Read-only: they cannot be updated
  or deleted (PATCH/DELETE return `404`).

Items omit `agent_configuration` — retrieve a single agent to see its full configuration.

## Query parameters

- `scope` 'private' | 'public': Which agents `GET /v1/voice_agents` returns. A distinct dimension from `agent_type` (how the conversation runs): `scope` is about ownership. `private` is the default so existing callers keep seeing exactly the set they own today. Named `scope` rather than `voice_agent_type` (voices' `voice_type` precedent) because `agent_type` is already taken on this resource. * `private` — only the caller's space owns. * `public` — presets owned by no space (`space_id IS NULL`); read-only to everyone.

## Response `200`

Successful Response

- ResponseListVoiceAgentListItemSchema
  - `code` integer
  - `data` VoiceAgentListItemSchema[]
    - `id` string, required
    - `name` string, required
    - `agent_type` 'liveavatar_agent' | 'elevenlabs_agent' | 'cartesia_agent' | 'openai_agent', required: How a voice agent's conversation is run. * `liveavatar_agent` — the managed speech-to-text => LLM => text-to-speech pipeline. * `elevenlabs_agent` — an agent you host on ElevenLabs, referenced by id. * `cartesia_agent` — an agent you host on Cartesia, referenced by id. * `openai_agent` — OpenAI Realtime or GPT-Live (picked by `model`) on your own OpenAI key.
    - `is_public` boolean, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `message` string

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-03** `8bc38e64ff31`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/liveavatar/apis/live-avatar-api/changes/v1/voice_agents/get.md)

---

[API](https://skmtc.dev/liveavatar/apis/live-avatar-api.md) - [All operations](https://skmtc.dev/liveavatar/apis/live-avatar-api/llms.txt) - [OpenAPI document](https://skmtc.dev/liveavatar/apis/live-avatar-api/revisions/8bc38e64ff31?raw)