API reference · Voices and catalog

List voices

GEThttps://goblins-call-api.onrender.com/v1/providers/voices

Returns a page of the voice library, which you can search and narrow by language and gender. Use a voice’s id as voice.speaker on an agent.

Needs a workspace API key.

Query parameters

qstringOptional

Searches voice names and descriptions.

languagestringOptional

A language from the catalog (hinglish) or an ISO code (hi).

genderenumOptionalfeminine · masculine · gender_neutral

Only voices of this gender.

limitintegerOptional1–100; default 100

How many voices to return.

afterstringOptional

The nextPage of the page before.

idstringOptional

Looks up this one voice instead of listing.

Response

voices[].previewboolean

Whether the voice has a sample clip to play.

nextPagestring

Pass as after for the next page; null on the last one.

Errors

503

The voice library is not available right now.

Every request can also answer 401, 429 and 500: see Errors.

curl "https://goblins-call-api.onrender.com/v1/providers/voices?language=hi&gender=feminine&limit=10" \
  -H "Authorization: Bearer $CRACKLE_API_KEY"

Response · 200 OK

{
  "voices": [
    {
      "id": "…",
      "name": "…",
      "tagline": "…",
      "description": "…",
      "gender": "feminine",
      "language": "hi",
      "preview": true
    }
  ],
  "hasMore": true,
  "nextPage": "…"
}