---
title: "GET /voice/catalog"
method: GET
path: "/voice/catalog"
---

# GET /voice/catalog

`GET /voice/catalog`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/voice/catalog`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Query parameters

- `gender` 'male' | 'female' | 'neutral'
- `language` string

## Response `200`

OK

- object
  - `voices` object[], required
    - `id` string, required
    - `name` string, required
    - `gender` 'male' | 'female' | 'neutral', required
    - `accent` string
    - `age` string
    - `descriptors` string[], required
    - `useCases` string[], required
    - `language` string, required
    - `sampleUrl` string
  - `source` 'live' | 'fallback', required: Where this list came from. `live` is the upstream catalog. `fallback` is the small committed set served when the upstream is not configured or unreachable — treat it as incomplete, not as the full range of available voices.

---

[API](https://skmtc.dev/useanima/apis/anima-api.md) · [All operations](https://skmtc.dev/useanima/apis/anima-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useanima/apis/anima-api/revisions/aaa148188980?raw)