---
title: "Get list of built in voices"
method: GET
path: "/saas/voice/builtin"
tags: ["Voice"]
---

# Get list of built in voices

`GET /saas/voice/builtin`

## Query parameters

- `sort` 'asc' | 'desc'
- `page_size` integer — Number of items per page `[1;100]`
- `token` string — Pagination token. Note:`sort` and `page_size` parameters are not allowed with the pagination `token` parameter
- `search` string — Search by name and description (min 2 characters, case-insensitive)
- `gender` Gender[] — Filter by gender label
- `age_group` AgeGroup[] — Filter by age group label
- `mood` Mood[] — Filter by mood label
- `lang` string — Filter by TTS sample language code
- `is_favorite` boolean — Filter by favorite flag for the current user
- `provider` VoiceProvider[] — Filter by TTS sample provider: `palabra` | `elevenlabs`. Only voices with a sample from the requested provider are returned, and `tts_sample` points to that provider's latest sample.

## Response `200`

Successful Response

- GenericResponsePayloadPageBuiltInVoice
  - `ok` boolean — Indicates if the request was successful or not.
  - `data` PageBuiltInVoiceOutput, required
    - `items` BuiltInVoiceOutput[], required — The list of items in the page
      - `voice_id` string, required — Voice ID
      - `utc_created_at` string, date-time, required — UTC created at
      - `utc_updated_at` string, date-time, required — UTC updated at
      - `voice_type` 'instantly_cloned' | 'instantly_cloned_builtin', required
      - `model` string — Model
      - `labels` Labels
        - `gender` 'Female' | 'Male' | 'Neutral'
        - `age_group` 'Young' | 'Middle Age' | 'Senior'
        - `mood` 'Neutral' | 'Happy' | 'Sad' | 'Angry'
      - `name` string, required — Name
      - `description` string — Description
      - `has_external_voice` boolean — Whether an external voice provider voice exists
      - `attributes` string[] — Custom voice attributes/tags
      - `tts_sample` BuiltInVoiceTTSSampleOutput
        - `user_id` string, required — User ID
        - `blob_id` string, uuid, required — TTS sample blob ID
        - `url` string, uri, required — TTS sample URL
        - `audio_metadata` AudioMetadata, required
          - `format` string, required — Audio format
          - `codec` string, required — Audio codec
          - `duration` number, required — Audio duration in seconds
          - `mime_type` 'audio/x-wav' | 'audio/wav' | 'audio/mp3' | 'audio/x-m4a' | 'audio/mpeg' | 'audio/flac' | 'audio/ogg' | 'video/webm' | 'video/mp4' | 'video/mpeg' | 'image/png' | 'image/jpeg' | 'image/webp', required — Core MIME types
        - `text` SingleLangTextSample, required
          - `content` string, required
          - `lang` 'ar' | 'ar-ae' | 'ar-sa' | 'az' | 'hy' | 'be' | 'bg' | 'bs' | 'ca' | 'cs' | 'cy' | 'da' | 'de' | 'el' | 'en' | 'en-au' | 'en-ca' | 'en-gb' | 'en-us' | 'es' | 'es-mx' | 'es-co' | 'es-ar' | 'es-ch' | 'es-la' | 'et' | 'fi' | 'fil' | 'fr' | 'fr-ca' | 'gl' | 'he' | 'hi' | 'hr' | 'hu' | 'id' | 'is' | 'it' | 'ja' | 'kk' | 'ko' | 'lt' | 'lv' | 'mk' | 'ms' | 'nl' | 'no' | 'pl' | 'pt' | 'pt-br' | 'ro' | 'ru' | 'sk' | 'sl' | 'sr' | 'sv' | 'sw' | 'ta' | 'th' | 'tr' | 'uk' | 'ur' | 'vi' | 'zh' | 'zh-hans' | 'zh-hant' | 'auto' | 'bn' | 'eu' | 'fa' | 'ga' | 'mn' | 'mr' | 'mt' | 'ug' | 'yue', required
        - `model` string, required — Model
        - `provider` 'palabra' | 'elevenlabs', required
        - `filename` string, required — Filename
        - `mime_type` 'audio/x-wav' | 'audio/wav' | 'audio/mp3' | 'audio/x-m4a' | 'audio/mpeg' | 'audio/flac' | 'video/webm' | 'video/mp4' | 'video/mpeg' | 'image/png' | 'image/jpeg' | 'image/webp', required — Allowed MIME types
        - `display_name` string, required — Display name
        - `description` string — Description
        - `utc_created_at` string, date-time, required — UTC created at
      - `tts_samples` BuiltInVoiceTTSSampleOutput[] — Latest TTS sample per provider
        - `user_id` string, required — User ID
        - `blob_id` string, uuid, required — TTS sample blob ID
        - `url` string, uri, required — TTS sample URL
        - `audio_metadata` AudioMetadata, required
          - `format` string, required — Audio format
          - `codec` string, required — Audio codec
          - `duration` number, required — Audio duration in seconds
          - `mime_type` 'audio/x-wav' | 'audio/wav' | 'audio/mp3' | 'audio/x-m4a' | 'audio/mpeg' | 'audio/flac' | 'audio/ogg' | 'video/webm' | 'video/mp4' | 'video/mpeg' | 'image/png' | 'image/jpeg' | 'image/webp', required — Core MIME types
        - `text` SingleLangTextSample, required
          - `content` string, required
          - `lang` 'ar' | 'ar-ae' | 'ar-sa' | 'az' | 'hy' | 'be' | 'bg' | 'bs' | 'ca' | 'cs' | 'cy' | 'da' | 'de' | 'el' | 'en' | 'en-au' | 'en-ca' | 'en-gb' | 'en-us' | 'es' | 'es-mx' | 'es-co' | 'es-ar' | 'es-ch' | 'es-la' | 'et' | 'fi' | 'fil' | 'fr' | 'fr-ca' | 'gl' | 'he' | 'hi' | 'hr' | 'hu' | 'id' | 'is' | 'it' | 'ja' | 'kk' | 'ko' | 'lt' | 'lv' | 'mk' | 'ms' | 'nl' | 'no' | 'pl' | 'pt' | 'pt-br' | 'ro' | 'ru' | 'sk' | 'sl' | 'sr' | 'sv' | 'sw' | 'ta' | 'th' | 'tr' | 'uk' | 'ur' | 'vi' | 'zh' | 'zh-hans' | 'zh-hant' | 'auto' | 'bn' | 'eu' | 'fa' | 'ga' | 'mn' | 'mr' | 'mt' | 'ug' | 'yue', required
        - `model` string, required — Model
        - `provider` 'palabra' | 'elevenlabs', required
        - `filename` string, required — Filename
        - `mime_type` 'audio/x-wav' | 'audio/wav' | 'audio/mp3' | 'audio/x-m4a' | 'audio/mpeg' | 'audio/flac' | 'video/webm' | 'video/mp4' | 'video/mpeg' | 'image/png' | 'image/jpeg' | 'image/webp', required — Allowed MIME types
        - `display_name` string, required — Display name
        - `description` string — Description
        - `utc_created_at` string, date-time, required — UTC created at
      - `is_favorite` boolean — Is favorite for the current user
    - `page_size` integer, required — The number of max items count in the page
    - `count` integer, required — The number of items in the page
    - `next` string — The next page token

## Other responses

- `default` — Default Response

---

[API](https://skmtc.dev/palabra/apis/palabra-api.md) · [All operations](https://skmtc.dev/palabra/apis/palabra-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/palabra/palabra-api/revisions/cb8721654525/schema)