Skip to main content
GET
List voices

Authorizations

Authorization
string
header
required

A Bearer token. Create keys in the portal under Settings > API keys (https://app.ryvo.so/developers). The token has the form ryvo_live_<64 hex characters> and is shown once.

Header: Authorization: Bearer ryvo_live_...

Query Parameters

limit
integer
default:20

Page size, 1 to 100. Default 20.

Required range: 1 <= x <= 100
cursor
string

The next_cursor of the previous page. Opaque.

Example:

"eyJvIjoyMH0"

provider
enum<string>

Only voices from this provider.

Available options:
elevenlabs,
cartesia,
deepgram
language
string

A two-letter language code the voice speaks, for example es or en.

Pattern: ^[a-zA-Z]{2,3}$
Example:

"es"

gender
enum<string>
Available options:
female,
male,
neutral
q
string

Case-insensitive search in the voice name.

Maximum string length: 100

true for the hand-picked voices only, false to exclude them.

Available options:
true,
false

Response

A page of voices.

The envelope of every list. data is typed per endpoint.

data
object[]
required
has_more
boolean
required

Whether another page exists.

Example:

true

next_cursor
string | null
required

Pass as ?cursor= to fetch the next page. null on the last page.

Example:

"eyJvIjoyMH0"