---
title: "Search voices."
method: GET
path: "/v1/voices/search"
tags: ["voices"]
---

# Search voices.

`GET /v1/voices/search`

Search and filter voices based on various parameters.

## Query parameters

- `page_size` number
- `next_page_token` string
- `name` string
- `description` string
- `language` string
- `gender` string
- `age` string
- `use_case` string
- `use_cases` string
- `style` string
- `model` string

## Response `200`

Paginated available voices response with next page token

- GetAPICharacterListResponse
  - `items` GetAPICharacterResponseData[], required — List of character items
    - `voice_id` string, required — Unique identifier for the voice
    - `name` string, required — Name of the voice
    - `description` string, nullable — Description of the voice
    - `age` string, required — Age of the voice
    - `gender` string, required — Gender of the voice
    - `use_case` string, required — Use case of the voice
    - `use_cases` string[], required — Use cases of the voice (array)
    - `language` string[], required — Languages supported by the voice
    - `styles` string[], required — Styles available for the voice
    - `models` string[], required — Models available for the voice
    - `samples` APISampleData[] — URL to the sample audio file for the voice
      - `language` string, required — Language of the sample
      - `style` string, required — Style of the sample
      - `model` string, required — Model of the sample
      - `url` string, required — URL to the sample audio file
    - `thumbnail_image_url` string — URL to the thumbnail image for the voice
  - `total` number, required — Total number of available characters (might be approximate or removed in future)
  - `next_page_token` string — Token for fetching the next page of results. Undefined if no more pages.

## Other responses

- `400` — Bad Request: Invalid style parameter (use either comma (OR) or semicolon (AND), not both)
- `401` — Unauthorized: Invalid API key
- `404` — Not Found: No voices found
- `500` — Internal Server Error: Failed to get voices

---

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