---
title: "List voices"
method: GET
path: "/api/v1/audio/voices"
tags: ["audio"]
---

# List voices

`GET /api/v1/audio/voices`

## Query parameters

- `page` integer, nullable
- `pageSize` integer
- `search` string
- `quality` 'studio'
- `language` 'en' | 'es' | 'fr' | 'de' | 'it' | 'pt' | 'pl' | 'hi' | 'ja' | 'zh' | 'ko' | 'ar' | 'ru' | 'nl' | 'sv' | 'tr' | 'id' | 'fil' | 'af' | 'hy' | 'az' | 'be' | 'bn' | 'bs' | 'bg' | 'ca' | 'cs' | 'da' | 'el' | 'et' | 'fi' | 'he' | 'hu' | 'is' | 'kn' | 'lv' | 'lt' | 'ms' | 'mr' | 'no' | 'ro' | 'sk' | 'sl' | 'sr' | 'ta' | 'te' | 'th' | 'uk' | 'ur' | 'vi'
- `accent` 'american' | 'british' | 'australian' | 'irish' | 'scottish' | 'indian' | 'canadian' | 'south african' | 'new zealand' | 'swedish' | 'italian' | 'german' | 'french' | 'spanish' | 'portuguese' | 'brazilian' | 'mexican' | 'arabic' | 'japanese' | 'chinese' | 'korean'
- `gender` 'male' | 'female' | 'neutral'
- `age` 'young' | 'middle_aged' | 'old'
- `useCase` 'conversational' | 'narrative_story' | 'characters_animation' | 'social_media' | 'informative_educational' | 'advertisement' | 'entertainment_tv'

## Response `200`

200

- object
  - `voices` object[], required
    - `voiceId` string, required
    - `name` string, required
    - `category` string, required
    - `previewUrl` string, uri, nullable, required
    - `labels` object, required
  - `page` number, required
  - `pageSize` number, required
  - `hasMore` boolean, required
  - `totalCount` number, required

## Other responses

- `401` — Missing, invalid, expired, or revoked API key.
- `403` — 403
- `429` — Rate limit reached — retry after the `Retry-After` header.

---

[API](https://skmtc.net/melius/apis/melius-api.md) · [All operations](https://skmtc.net/melius/apis/melius-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/melius/melius-api/revisions/c48e2a9e4b72/schema)