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

# List Voices

`GET /v1/voices`

Retrieve a paginated list of available text-to-speech voices. Use query parameters to filter by gender, provider, language, or accent, and to search by name or description.

## Query parameters

- `limit` integer
- `offset` integer
- `search` string
- `gender` string
- `provider` string
- `language` string
- `accent` string
- `sort_by` 'name' | 'created_at'
- `sort_order` 'asc' | 'desc'

## Response `200`

Paginated list of voices with available filter values.

- ListVoicesResponse
  - `voices` VoiceResponse[]
    - `id` integer — Unique numeric ID of the voice.
    - `name` string — Display name of the voice.
    - `voice_id` string — Provider-specific voice identifier used when configuring a bot.
    - `sample_url` string — URL to an audio sample of the voice.
    - `provider` string — TTS provider (e.g. 'elevenlabs', 'deepgram').
    - `gender` string — Gender of the voice (e.g. 'male', 'female').
    - `language` string — Primary language code.
    - `languages` string[] — All supported language codes.
    - `accent` string — Accent or regional variant, if applicable.
    - `age` string — Approximate age group (e.g. 'young', 'middle-aged').
    - `ethnicity` string — Ethnicity descriptor, if available.
    - `characteristics` string[] — Descriptive tags (e.g. 'warm', 'professional', 'energetic').
    - `description` string — Free-text description of the voice.
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `pagination` object
    - `limit` integer
    - `offset` integer
    - `total` integer
    - `has_more` boolean
  - `filters` object — Lists of distinct values available for each filter field, useful for building filter UIs.
    - `available_genders` string[]
    - `available_providers` string[]
    - `available_languages` string[]
    - `available_accents` string[]

---

[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/71c32e6ffd95/schema)