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

# List voices

`GET /v2/voices`

Returns a cursor-paginated catalogue of available voices.
Use the `voice` field from a voice record when creating or updating an agent.

## Query parameters

- `page_size` integer
- `cursor` string
- `search` string
- `gender` 'MALE' | 'FEMALE' | 'NEUTRAL'
- `provider` 'OpenAI' | 'ElevenLabs' | 'Deepgram' | 'Cartesia' | 'Rime' | 'Sarvam'
- `language` string
- `accent` string
- `sort_by` 'name' | 'created_at'
- `sort_order` 'asc' | 'desc'

## Response `200`

Paginated list of voices.

- ListVoicesResponse
  - `has_more` boolean, required — Whether more records exist after this page.
  - `next_cursor` string — Opaque cursor to pass as `cursor` in the next request.
  - `voices` VoiceResponse[], required
    - `id` integer, required
    - `name` string, required
    - `provider` 'OpenAI' | 'ElevenLabs' | 'Deepgram' | 'Cartesia' | 'Rime' | 'Sarvam', required
    - `gender` 'MALE' | 'FEMALE' | 'NEUTRAL'
    - `language` string
    - `accent` string
    - `preview_url` string
    - `created_at` string, date-time

## Other responses

- `400` — Validation error or invalid request body.
- `401` — Missing or invalid API key.
- `429` — Rate limit exceeded.
- `500` — Unexpected server error.

---

[API](https://skmtc.net/openmicai/apis/openmic-v1-external-api.md) · [All operations](https://skmtc.net/openmicai/apis/openmic-v1-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openmicai/openmic-v1-external-api/revisions/58dc5cff0ca7/schema)