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

# Get Voices

`GET /v1/voices`

Get information on available voices.

Parameters:
- age: Filter by voice age
- gender: Filter by voice gender
- accent: Filter by voice accent
- mood: Filter by voice mood
- style: Filter by voice style
- language: Filter by voice language
- limit: Maximum number of voices to return
- offset: Number of voices to skip
- private: Include private voices
- name: Filter by voice name
- uuid: Filter by voice UUID
- model: Filter by model ID (e.g. "polly_neural", "google_standard", "azure_neural")
- tag: Filter by voice tag (e.g. "characters", "celebrities", "accents")
          For Polly voices:
          - "polly_neural" returns voices that support the neural engine
          - "polly_standard" returns voices that support the standard engine
          For Google voices:
          - "google_wavenet" returns WaveNet voices
          - "google_neural2" returns Neural2 voices
          - "google_standard" returns standard voices
          For Azure voices:
          - "azure_neural" returns neural voices

## Query parameters

- `age` string
- `gender` string
- `accent` string
- `mood` string
- `style` string
- `language` string
- `limit` integer
- `offset` integer
- `private` boolean
- `name` string
- `uuid` string
- `model` string
- `search_term` string
- `tag` string

## Headers

- `authorization` string

## Response `200`

Successful Response

- GetVoicesResponse
  - `total` integer, required
  - `voices` Voice[], required
    - `display_name` string, required
    - `voicemodel_uuid` string, required
    - `is_private` boolean
    - `age` string
    - `gender` string
    - `accent` string
    - `style` string
    - `mood` string
    - `image_url` string
    - `sample_url` string
    - `name` string
    - `features` string[]
    - `language` string
    - `description` string
    - `tags` string[]

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/uberduck/apis/uberduck-text-to-speech-api.md) · [All operations](https://skmtc.dev/uberduck/apis/uberduck-text-to-speech-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/uberduck/uberduck-text-to-speech-api/revisions/fbf2fc6fd0ae/schema)