Skip to navigation

List Catalog Providers

List all available speech synthesis providers in the catalog.

Returns the speech synthesis providers available to your account — each with its display name, number of available models, a beta badge flag, and a HATEOAS models link to GET /providers/{provider}/models. The response contains only customer-facing metadata; cost, credentials, and base URLs are never included.

Staff can restrict a provider or an individual model to internal accounts or to paying customers. Restricted entries are omitted from this list entirely rather than returned and marked, so the list is exactly what your account may use. beta is a display badge only and never affects availability; a provider carries it only when EVERY model available to you under it is beta, so a single experimental model among mature ones is badged on the model rather than on the provider.

This endpoint is the starting point for building a provider/model/voice selection flow. The typical traversal is: list providers → follow models link → follow voices link for the chosen model. Requires X-Workspace-Id and the catalog:read scope.

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

Response

Successful Response
datalist of objects
metaobject
paginationobject

Errors

422
Unprocessable Entity Error