Skip to main content
GET
List Voices

Authorizations

Authorization
string
header
required

API key from Settings > Developer > REST API

Headers

X-Voice-Engines
string | null

The voice engines this client understands, comma-separated: elevenlabs,fishaudio,inworld. ElevenLabs is always on; Fish Audio models and voices appear only for a client that lists fishaudio (or, on GET /v1/voices, asks for provider=fishaudio or a featured/community category), and Inworld's only for a client that lists inworld (or asks for provider=inworld).

Moda-Version
enum<string>
default:2026-05-01

Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.

Available options:
2026-04-12,
2026-05-01
Example:

"2026-05-01"

Query Parameters

query
string | null
Maximum string length: 200
language
string | null
Maximum string length: 16
accent
string | null
Maximum string length: 100
use_case
string | null
Maximum string length: 100
gender
string | null
Maximum string length: 16
provider
string | null

elevenlabs, fishaudio or inworld: only that engine's voices.

Maximum string length: 32
category
string | null

premade (ElevenLabs and Inworld stock voices), featured (Fish Audio voices whose rights Fish secured, celebrity and creator voices included) or community (popular public Fish Audio voices).

Maximum string length: 32
include_unavailable
boolean
default:false
cursor
string | null
Maximum string length: 1024
limit
integer
default:30
Required range: 1 <= x <= 100

Response

Successful Response

data
Voice · object[]
required
next_cursor
string | null
required
returned
integer
required
has_more
boolean
required
limit
integer
required
total
integer
required
filters_applied
VoiceFiltersApplied · object
required
object
string
default:list
Allowed value: "list"