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

# List Voice Options

> StateSet Voice API operation.

StateSet Voice API operation.

### Response

`VoiceOptionsResponse`

**providers** `VoiceProviderOptions[]` *required*

**VoiceProviderOptions**

**provider** `string` *required*

Realtime provider key: 'xai' (grok-\* models) or 'openai'.

**voices** `VoiceOptionEntry[]` *required*

**VoiceOptionEntry**

**default** `boolean` *required*

True for the provider's platform-default voice.

**description** `string` *required*

Provider-published personality description; empty when unpublished.

**display\_name** `string` *required*

**gender** `string,null`

'male' / 'female' where the provider publishes it.

**name** `string` *required*

Canonical wire name — the value to store in agent config `voice`.

### Status codes

| Code | Meaning |
| - | - |
| `200` | Built-in voices grouped by realtime provider |
| `401` | Missing or invalid API credential |

```bash cURL theme={null}
curl --request GET \
  --url 'https://api.voice.stateset.com/api/v1/voice/voice-options' \
  --header "Authorization: Bearer $STATESET_VOICE_API_KEY"
```

```json 200 theme={null}
{
  "providers": [
    {
      "provider": "xai",
      "voices": []
    }
  ]
}
```


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