---
title: "Search Voices"
method: POST
path: "/tools/search/voices"
tags: ["accepts-api-key"]
---

# Search Voices

`POST /tools/search/voices`

## Request

- Base URL: `https://api.tellers.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tellers.ai/tools/search/voices`
- Auth: none declared

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Request body

- SearchVoicesRequest
  - `search` string, nullable: Free-text query (name, description, use case).
  - `language` string, nullable: Filter by language code, e.g. 'en'.
  - `limit` integer: Number of results.

## Response `200`

Successful Response

- SearchVoicesResponse
  - `voices` ElevenLabsVoice[], required
    - `voice_id` string, required: The ElevenLabs voice ID.
    - `name` string, required: Display name of the voice.
    - `accent` string, nullable: Accent of the voice, if provided.
    - `gender` string, nullable: Gender of the voice, if provided.
    - `age` string, nullable: Age descriptor of the voice, if provided.
    - `language` string, nullable: Primary language of the voice, if provided.
    - `category` string, nullable: Voice category (generated, cloned, premade, professional, famous, high_quality).
    - `descriptive` string, nullable: Short descriptive text for the voice, if provided.
    - `use_case` string, nullable: Primary use-case of the voice, if provided.
    - `preview_url` string, nullable: Preview audio URL for the voice, if provided.
  - `has_more` boolean, required

## Other responses

- `402`: Not enough Tellers tokens to run this tool. The call was refused before the tool ran, so nothing was charged. Buy more tokens or wait for the next subscription grant.
- `403`: The account's email is not verified yet, so it cannot spend tokens. Nothing was charged. `detail.code` is `EMAIL_NOT_VERIFIED`.
- `422`: Validation Error

---

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