---
title: "List Voices"
method: GET
path: "/v1/voices"
tags: ["Voices"]
---

# List Voices

`GET /v1/voices`

## Request

- Base URL: `https://api.call2me.app`
- URL: `https://api.call2me.app/v1/voices`
- Auth: HTTP bearer

List available voices.

Filter by language, provider, or gender. Multilingual voices match any language filter.

## Query parameters

- `language` string, nullable: Filter by language code
- `provider` string, nullable: Filter by provider
- `gender` string, nullable: Filter by gender

## Response `200`

Successful Response

- Voice[]
  - `voice_id` string, required: Unique identifier in format 'provider-name'
  - `name` string, required: Human-readable voice name
  - `provider` 'elevenlabs' | 'cartesia' | 'deepgram' | 'openai-realtime', required: TTS provider
  - `language` string, required: Primary language or 'multilingual'
  - `gender` 'male' | 'female' | 'neutral', required: Voice gender
  - `description` string, nullable: Voice characteristics description
  - `preview_url` string, nullable: URL to sample audio
  - `supported_languages` string[], nullable: List of supported language codes
  - `provider_voice_id` string, nullable: Real provider voice ID (ElevenLabs/Google) used for TTS
  - `model` string, nullable: TTS model for this voice (e.g. eleven_flash_v2_5)

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/call2me/apis/call2me-api.md) · [All operations](https://skmtc.dev/call2me/apis/call2me-api/llms.txt) · [OpenAPI document](https://skmtc.dev/call2me/apis/call2me-api/revisions/3951f9b7e47d?raw)