Skip to main content
GET
List voices across all providers (unified)
The unified endpoint is the easiest way to find a voice. It fans out to every requested provider in parallel, normalizes the result, then applies your filters.

Examples

Only English female voices across all providers

German voices from ElevenLabs and Cartesia only

Australian-accent voices

How filters work

  • language — accepts ISO short codes (en), BCP-47 (en-US) or English names (English). Matches are inclusive: filter en returns en, en-US, en-GB, English, etc.
  • gendermale / female / neutral. Also accepts masculine, feminine, m, f (case-insensitive).
  • accent — substring match (case-insensitive). american matches American, North American, etc.
  • providers — comma-separated list (?providers=elevenlabs,cartesia). When omitted, every supported provider is queried in parallel.

Response

The response always contains:
  • voices[] — the paginated, filtered list (each entry has voiceId, name, provider, previewUrl, filters)
  • total — total matches before pagination
  • providersQueried — providers that were actually queried
  • providersFailed — providers that errored (e.g. missing workspace API key) along with the error message — the request still succeeds
Each voice has a ready-to-play previewUrl MP3. Drop it straight into an <audio> element.
This endpoint is read-only and does not consume credits.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

providers
string
language
string
gender
string
accent
string
modelId
string
sampleText
string
limit
integer
default:100
Required range: 1 <= x <= 500
offset
integer
default:0
Required range: x >= 0

Response

Successful response

total
number
required
limit
number
required
offset
number
required
providersQueried
string[]
required
providersFailed
object[]
required
voices
object[]
required