# List Voices

`GET /v1/voices`

Every preset voice with the models that speak it, then your designed and cloned voices, newest first.

Preset entries use the voice name as `id` (for example `Cherry`) and list the models that speak it: every preset on `spicy-voice-1`, a subset on `spicy-voice-1-expressive`. Your own voices have a `vc_...` id and are spoken by `spicy-voice-1-custom`. Sandbox keys see the presets only.

Base URL: `https://api.spicyapi.com`

## Authorizations

- `Authorization` (string, header, required): Bearer authentication header of the form `Bearer <token>`, where `<token>` is your SpicyAPI key (`sk-spicy-…`). Create one in the dashboard under API Keys.

## Request

```bash
curl --request GET \
  --url https://api.spicyapi.com/v1/voices \
  --header 'Authorization: Bearer $SPICYAPI_KEY'
```

## Response: 200 application/json

Successful Response

- `data` (Voice · object[], required): Preset voices, then yours.
  - `id` (string, required): What you pass as `voice`: the preset name, or `vc_...` for your own voices.
  - `object` (string, required): Always `voice`.
  - `kind` (string, required): `preset`, `designed` or `cloned`.
  - `name` (string, required): Display name.
  - `models` (string[], required): The speech models that speak this voice; `spicy-voice-1-custom` for your own.
  - `description` (string | null, optional): Designed voices: the description they were made from.
  - `source_audio_id` (string | null, optional): Cloned voices: the clip (`au_...`) they were cloned from.
  - `preview_url` (string | null, optional): Designed voices: a WAV of the preview line in the new voice.
  - `consent_attested_at` (integer | null, optional): Cloned voices: Unix timestamp of your consent attestation.
  - `created` (integer | null, optional): Unix timestamp. Custom voices only.

```json
{
  "object": "list",
  "data": [
    { "id": "Cherry", "object": "voice", "kind": "preset", "name": "Cherry", "models": ["spicy-voice-1", "spicy-voice-1-expressive"] },
    { "id": "Jennifer", "object": "voice", "kind": "preset", "name": "Jennifer", "models": ["spicy-voice-1"] },
    {
      "id": "vc_4e1b7c9a2d5f8e0b3c",
      "object": "voice",
      "kind": "cloned",
      "name": "My voice",
      "models": ["spicy-voice-1-custom"],
      "description": null,
      "source_audio_id": "au_3c9f1e7a2b4d6f80a1c2",
      "preview_url": null,
      "consent_attested_at": 1758553200,
      "created": 1758553200
    }
  ]
}
```