List Voices

List TTS voices available to the current workspace. Every filter accepts repeat-key OR semantics: `?gender=female&gender=neutral&category=narration&source=platform&source=workspace`. Filters combine across fields with AND; within a field, values OR. `language` matches a voice when any of its declared locales matches any requested value. Platform voices with no declared locales (catalog gaps) are treated as general-use and match every language filter. User-uploaded / cloned voices with no declared locales are excluded — that state means "language unknown" pending the clone flow's language detection. Multi-sort: `sort` and `order` are parallel lists. `?sort=uses_count&sort=name&order=desc&order=asc` orders primarily by uses_count DESC, secondarily by name ASC. When `order` is shorter than `sort`, missing entries default per-field: `name=asc, created_at=desc, uses_count=desc`. When `sort` is omitted, list defaults to newest-first (or most-recently-favorited-first if `favorites_only=true`). Every sort path appends `Voice.id ASC` as a deterministic tiebreaker for pagination stability.

Authentication

AuthorizationBearer
Clerk JWT token
OR
AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Headers

X-Workspace-Idstring or nullOptional

Query parameters

offsetintegerOptional>=0Defaults to 0
Number of results to skip for pagination.
limitintegerOptional1-100Defaults to 20

Maximum number of results to return (1–100).

favorites_onlybooleanOptionalDefaults to false
When true, return only voices in the workspace's favorites list.
sourcelist of enums or nullOptional

Repeat for OR across scopes: platform for system-provided voices, workspace for workspace-owned voices.

Allowed values:
genderlist of enums or nullOptional
Repeat for OR
Allowed values:
agelist of enums or nullOptional
Repeat for OR
Allowed values:
categorylist of enums or nullOptional
Repeat for OR
accentlist of enums or nullOptional
Repeat for OR
searchstring or nullOptional<=200 characters

Full-text search against voice name, description, and tags.

sortlist of enums or nullOptional

Repeat for multi-sort. Pairs with order index-wise.

Allowed values:
orderlist of enums or nullOptional

Parallel to sort[]; shorter is padded with per-field defaults.

Allowed values:
providerlist of enums or nullOptional

Repeat for OR, e.g. ?provider=elevenlabs&provider=rime

Allowed values:
modellist of strings or nullOptional

Repeat for OR. Filters platform voices by TTS model, e.g. ?model=arcana&model=sonic-2

languagelist of enums or nullOptional

Repeat for OR, e.g. ?language=en-us&language=ko-kr

Response

Successful Response
datalist of objects
metaobject
paginationobject
PaginationMeta variant for endpoints that compute an unpaginated total.

Errors

422
Unprocessable Entity Error