---
title: "Search voices"
method: POST
path: "/api/v1/audio/voices/search"
tags: ["audio"]
---

# Search voices

`POST /api/v1/audio/voices/search`

## Request

- Base URL: `https://api.melius.com`
- URL: `https://api.melius.com/api/v1/audio/voices/search`
- Auth: HTTP bearer and API key in header `x-team-id`

## Request body

- object
  - `pageSize` integer
  - `cursor` string
  - `includeCount` boolean
  - `filters` object
    - `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
  - `data` object[], required
    - `voiceId` string, required
    - `name` string, required
    - `category` string, required
    - `previewUrl` string, uri, nullable, required
    - `labels` object, required
  - `pageSize` integer, required
  - `count` integer, nullable, required
  - `hasMore` boolean, required
  - `nextCursor` string, nullable, required

## Other responses

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

## Changes

- **2026-11-03** `2a857511f605`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/melius/apis/melius-api/changes/api/v1/audio/voices/search/post.md)

---

[API](https://skmtc.dev/melius/apis/melius-api.md) - [All operations](https://skmtc.dev/melius/apis/melius-api/llms.txt) - [OpenAPI document](https://skmtc.dev/melius/apis/melius-api/revisions/2a857511f605?raw)