---
title: "List voices"
method: GET
path: "/audio/voices"
---

# List voices

`GET /audio/voices`

## Request

- Base URL: `https://api.shortgenius.com/v1`
- URL: `https://api.shortgenius.com/v1/audio/voices`
- Auth: HTTP bearer

Gets a list of all voices available for text-to-speech.

## Query parameters

- `locale` 'af-ZA' | 'id-ID' | 'ms-MY' | 'ca-ES' | 'cs-CZ' | 'da-DK' | 'de-DE' | 'en-US' | 'es-ES' | 'es-419' | 'fr-CA' | 'fr-FR' | 'hr-HR' | 'it-IT' | 'hu-HU' | 'nl-NL' | 'no-NO' | 'pl-PL' | 'pt-BR' | 'pt-PT' | 'ro-RO' | 'sk-SK' | 'fi-FI' | 'sv-SE' | 'vi-VN' | 'tr-TR' | 'el-GR' | 'ru-RU' | 'sr-SP' | 'uk-UA' | 'hy-AM' | 'he-IL' | 'ur-PK' | 'ar-SA' | 'hi-IN' | 'th-TH' | 'ko-KR' | 'ja-JP' | 'zh-CN' | 'zh-TW' | 'auto': The locale for which to retrieve voices.
- `page` number: The page number to retrieve.
- `limit` number: The maximum number of items per page.

## Response `200`

Successful response

- Voice[]: A list of available TTS voices.
  - `id` string, required: Unique ID of the voice.
  - `name` string, required: Name of the voice.
  - `description` string, nullable, required: Description of the voice.
  - `avatar_url` string, nullable: Avatar url of the voice.
  - `flag_url` string, nullable: Flag url of the voice.
  - `tags` object, nullable, required: Tags of the voice. Describe the characteristics of the voice.
    - `language` string, nullable
    - `accent` string, nullable
    - `age` string, nullable
    - `category` string, nullable
    - `gender` string, nullable
    - `tone` string, nullable
    - `useCase` string, nullable
  - `preview_url` string, nullable, required: URL of the preview audio of the voice.
  - `locale` 'af-ZA' | 'id-ID' | 'ms-MY' | 'ca-ES' | 'cs-CZ' | 'da-DK' | 'de-DE' | 'en-US' | 'es-ES' | 'es-419' | 'fr-CA' | 'fr-FR' | 'hr-HR' | 'it-IT' | 'hu-HU' | 'nl-NL' | 'no-NO' | 'pl-PL' | 'pt-BR' | 'pt-PT' | 'ro-RO' | 'sk-SK' | 'fi-FI' | 'sv-SE' | 'vi-VN' | 'tr-TR' | 'el-GR' | 'ru-RU' | 'sr-SP' | 'uk-UA' | 'hy-AM' | 'he-IL' | 'ur-PK' | 'ar-SA' | 'hi-IN' | 'th-TH' | 'ko-KR' | 'ja-JP' | 'zh-CN' | 'zh-TW' | 'null', nullable, required: Locale of the voice.
  - `source` 'Cartesia' | 'CartesiaClonedVoice' | 'ElevenLabs' | 'ElevenLabsShared' | 'FishAudio' | 'FishAudioClonedVoice' | 'OpenAI', required: Source of the voice.

## Other responses

- `400`: Invalid request

---

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