Skip to main content
GET
/
api
/
voices
/
search
GET /api/voices/search?provider=cartesia&query=warm&language=en&gender=feminine

{
  "voices": [
    {
      "id": "f786b574-daa5-4673-aa0c-cbe3e8534c02",
      "name": "Warm Narrator",
      "description": "Conversational female voice",
      "gender": "feminine",
      "language": "en",
      "preview_url": null,
      "has_preview": true
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.getbutter.ai/llms.txt

Use this file to discover all available pages before exploring further.

Search provider voice catalogs used in the agent voice picker.

​
Query Parameters

​
provider
string
required
Voice provider. Supported values: cartesia, elevenlabs.
​
query
string
Free-text search term.
​
language
string
Filter by language code (for example en).
​
gender
string
Optional gender filter. Most relevant for Cartesia voice search.
​
cursor
string
Cursor for fetching the next page.

​
Response

​
voices
array
Matching voices.
​
voices[].id
string
Provider voice ID.
​
voices[].name
string
Voice name.
​
voices[].description
string
Voice description, when available.
​
voices[].gender
string|null
Voice gender metadata.
​
voices[].language
string|null
Voice language metadata.
​
voices[].preview_url
string|null
Direct preview URL when exposed by provider.
​
voices[].has_preview
boolean
Indicates whether a preview sample is available.
​
has_more
boolean
Whether more results are available.
​
next_cursor
string|null
Cursor for the next page.
GET /api/voices/search?provider=cartesia&query=warm&language=en&gender=feminine

{
  "voices": [
    {
      "id": "f786b574-daa5-4673-aa0c-cbe3e8534c02",
      "name": "Warm Narrator",
      "description": "Conversational female voice",
      "gender": "feminine",
      "language": "en",
      "preview_url": null,
      "has_preview": true
    }
  ],
  "has_more": false,
  "next_cursor": null
}