---
title: "List Voices"
method: GET
path: "/v1/voices/list"
tags: ["voices"]
---

# List Voices

`GET /v1/voices/list`

## Query parameters

- `page` integer
- `size` integer
- `sort_column` string, nullable
- `sort_desc` boolean, nullable

## Response `200`

Successful Response

- VoicePage
  - `items` union[], required
    - union
      - AzureVoice
        - `id` string, uuid, required
        - `user_id` string, uuid, required
        - `type` 'voice_azure', required
        - `voice_name` string, required
        - `pitch` integer
        - `rate` integer
      - RimeVoice
        - `id` string, uuid, required
        - `user_id` string, uuid, required
        - `type` 'voice_rime', required
        - `speaker` string, required
        - `speed_alpha` number, nullable
        - `model_id` union
          - 'mist' | 'v1'
          - Undefined
      - ElevenLabsVoice
        - `id` string, uuid, required
        - `user_id` string, uuid, required
        - `type` 'voice_eleven_labs', required
        - `voice_id` string, required
        - `stability` number, nullable
        - `similarity_boost` number, nullable
        - `api_key` string, nullable
        - `optimize_streaming_latency` integer, nullable
        - `model_id` string, nullable
        - `experimental_input_streaming` boolean
      - PlayHtVoice
        - `id` string, uuid, required
        - `user_id` string, uuid, required
        - `type` 'voice_play_ht', required
        - `voice_id` string, required
        - `api_user_id` string, nullable
        - `api_key` string, nullable
        - `version` '1' | '2'
        - `speed` number, nullable
        - `quality` 'faster' | 'draft' | 'low' | 'medium' | 'high' | 'premium', nullable
        - `temperature` number, nullable
        - `top_p` number, nullable
        - `text_guidance` number, nullable
        - `voice_guidance` number, nullable
        - `experimental_remove_silence` boolean
      - VocodeVoice
        - `id` string, uuid, required
        - `user_id` string, uuid, required
        - `type` 'voice_vocode', required
        - `voice_id` 'joe', required
  - `page` integer, required
  - `size` integer, required
  - `has_more` boolean, required
  - `total` integer, required
  - `total_is_estimated` boolean, required

## Other responses

- `422` — Validation Error

## Changes

- **2024-08-14** `63991d99e2e1` — 15 breaking, 16 info
  - response property `items/items/oneOf[subschema #2: RimeVoice]/speed_alpha` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/oneOf[subschema #3: ElevenLabsVoice]/api_key` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/oneOf[subschema #3: ElevenLabsVoice]/model_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/items/oneOf[subschema #3: ElevenLabsVoice]/optimize_streaming_latency` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - …27 more
- **2024-04-19** `55ae0e0bb01f` — 2 info
  - added the required property `total` to the response with the `200` status
  - added the required property `total_is_estimated` to the response with the `200` status
- **2024-04-15** `47ab17602d64` — 1 info
  - added the optional property `items/items/oneOf[subschema #2: RimeVoice]/model_id` to the response with the `200` status
- **2024-03-18** `8b2983fa7531` — 5 info
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `size`
  - added the new optional `query` request parameter `sort_column`
  - added the new optional `query` request parameter `sort_desc`
  - …1 more
- …earlier changes not shown

[Full history](https://skmtc.dev/vocodedev/apis/vocode-hosted-api/changes/v1/voices/list/get.md)

---

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