> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getbluejay.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /v1/voices

> List the voices you can use.

Returns the languages, accents and voices your workspace can give a Digital Human or persona. It is the live list of what you can pick. A voice ID never changes, so it is safe to store.- `voices` has one entry per voice and language. A voice that speaks three languages appears three times.
- Your organization's cloned and generated voices come last, with `own: true` and no `accent`. They speak any language. The `accent` filter does not apply to them, and the `gender` filter keeps the ones with no gender.
- The stock voices depend on the voice providers your organization has.
- `sample_url` expires after 15 minutes. Call again for a new one.Rate limit: 100 requests per minute.## Set a voice[Create Digital Humans](https://docs.getbluejay.ai/api-reference/endpoint/create-digital-humans-v2.md), [Update Digital Human](https://docs.getbluejay.ai/api-reference/endpoint/update-digital-human.md), [Create Persona](https://docs.getbluejay.ai/api-reference/endpoint/create-persona.md) and [Update Persona](https://docs.getbluejay.ai/api-reference/endpoint/update-persona.md) take a voice in one of two ways:- **`voice_id`** pins that exact voice, such as `cartesia-connie`. It must speak the Digital Human's `language`. If you create one with `voice_id` and no `language`, Bluejay uses English, or another language the voice speaks.
- **`language`, `accent` and `gender`** pin the voice that `defaults` lists for that combination. A `language` alone uses its `default_accent`. Without `gender`, Bluejay picks one at random. A combination with no voice returns `400` with the valid choices.A Digital Human created with no voice fields gets an English voice with a random gender. A persona has a voice only once you set `accent`, `voice_id` or `custom_voice_id`. Until then, each Digital Human that runs as it keeps its own voice.On an update, a voice field counts only when it differs from the stored value. Changing `accent` or `gender` without `voice_id` pins that combination's default voice. Changing only `language` keeps the voice if it speaks the new language. If it does not, also send an `accent` of the new language or a `voice_id`.- **Cloned voices:** pin one with its `voice_id` from this list, or set `custom_voice_id` to the `voice_id` from [Create Voice Clone](https://docs.getbluejay.ai/api-reference/endpoint/create-voice-clone.md). Bluejay stores no accent or gender for a clone, so both come back null. Only Digital Humans and personas in the clone's workspace can use it.
- **Fluency:** `fluency` works only on voices with `supports_fluency`, which are ElevenLabs voices in English or Urdu. Bluejay saves `native` for any other voice.
- **Older values:** older accent values still work on input. So do the language codes `ml` for multilingual and `ad` for auto-detect, which responses return as `multi` and `auto`.## Query parameters

\<table><thead><tr><th>Name</th>
            \<th>Type</th>
            \<th>Required</th>
            \<th>Description</th></tr></thead>
        \<tbody /></table>

## Headers

\<table><thead><tr><th>Name</th>
            \<th>Type</th>
            \<th>Required</th>
            \<th>Description</th></tr></thead>
        \<tbody /></table>

## Response

\<table><thead><tr><th>Name</th>
            \<th>Type</th>
            \<th>Required</th>
            \<th>Description</th></tr></thead>
        \<tbody /></table>

## Status codes| Status | Meaning |
| - | - |
| `200` | Successful Response |
| `422` | Validation Error |## Example request```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
curl --request GET \
  --url https://api.getbluejay.ai/v1/voices \
  --header 'X-API-Key: <api-key>'
```## Example response```json 200 theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "languages": [
    {
      "language": "<string>",
      "language_label": "<string>",
      "default_accent": "<string>",
      "accents": [
        {
          "accent": "<string>",
          "accent_label": "<string>",
          "is_default": true
        }
      ]
    }
  ],
  "voices": [
    {
      "voice_id": "<string>",
      "name": "<string>",
      "gender": "<string>",
      "age": "<string>",
      "language": "<string>",
      "accent": "<string>",
      "is_default": true,
      "supports_fluency": true,
      "sample_url": "<string>",
      "own": true
    }
  ],
  "defaults": [
    {
      "language": "<string>",
      "accent": "<string>",
      "gender": "<string>",
      "voice_id": "<string>"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.