---
title: "Get Voices"
method: GET
path: "/waves/v1/{model}/get_voices"
tags: ["Voices"]
---

# Get Voices

`GET /waves/v1/{model}/get_voices`

List voices available for Lightning v3.1. The response is the union of the standard and Pro voice catalogs — the API does not return a per-voice "is Pro" flag, so consult the [Lightning v3.1 Pro](/models/model-cards/text-to-speech/lightning-v-3-1-pro) and [Lightning v3.1](/models/model-cards/text-to-speech/lightning-v-3-1) model cards for the canonical per-pool voice lists. Use the `voice_id` from this response together with `"model": "lightning_v3.1"` (default) or `"model": "lightning_v3.1_pro"` on the unified `/waves/v1/tts` route to pick the pool.

## Path parameters

- `model` 'lightning-v3.1', required

## Response `200`

Voices retrieved successfully.

- object
  - `voices` object[] — List of available voices.
    - `voiceId` string, required — Unique Voice ID. Pass this value as `voice_id` on `POST /waves/v1/tts` (or the streaming route).
    - `displayName` string, required — Display name for the voice.
    - `tags` object — Tag metadata used to identify the voice's characteristics. Filter on these fields to find voices for a target language, accent, or use case. Fields may be empty on some voices.
      - `language` string[] — Languages the voice was trained on (e.g., `["english"]`, `["english", "hindi"]`).
      - `accent` string — Accent of the voice (e.g., `american`, `british`, `indian`).
      - `gender` string — Gender of the voice (`male` or `female`).
      - `age` string — Age range of the voice (e.g., `young`, `middle aged`, `senior`).
      - `emotions` string[] — Emotional ranges the voice supports. May be empty.
      - `usecases` string[] — Recommended use cases for the voice (e.g., `conversational`, `narration`).

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Server error occurred

---

[API](https://skmtc.net/smallest-inc/apis/get-voices.md) · [All operations](https://skmtc.net/smallest-inc/apis/get-voices/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smallest-inc/get-voices/versions/2705a966e2ea/schema)