Skip to content
API ReferenceEndpoints

List voices

GET/api/v1/voices

Send a GET request with optional query parameters. Listing voices is free and doesn't cost any characters.

Every default voice has an ID that starts with jsf_default_. Pass it as voice_id to Text to speech.

Query parameters
languagestring
ISO 639-1 code, e.g. en, ur, ar, hi.
genderstring
male or female.
localestring
Full locale, e.g. en-GB, ur-IN.
searchstring
Matches the voice name or ID. Up to 80 characters.
pagenumberDefaults to 1
Page number, starting at 1.
limitnumberDefaults to 50
Voices per page, 1 to 200.

Returns

200 OK
successboolean
Always true on success.
dataarray
The voices on this page.
paginationobject
page, limit, total, total_pages and has_more.
filtersobject
The filters that were applied.
languagesarray
Every available language with its code, name and voice count. Use it to build a language dropdown.
Fetch the whole catalog

Use limit=200 and increase page until has_more is false. The catalog rarely changes, so cache it on your side.

Request
curl "https://www.jsflabs.io/api/v1/voices?language=ur&gender=female" \
  -H "x-api-key: jsf_your_api_key"
Response200 OK
Response
{
  "success": true,
  "data": [
    {
      "voice_id": "jsf_default_aaliya",
      "name": "Aaliya",
      "gender": "female",
      "language": "ur",
      "language_name": "Urdu",
      "locale": "ur-IN",
      "type": "default",
      "provider": "jsf-labs"
    }
  ],
  "pagination": { "page": 1, "limit": 50, "total": 20, "total_pages": 1, "has_more": false },
  "filters": { "language": "ur", "locale": null, "gender": "female", "search": null },
  "languages": [
    { "code": "ar", "name": "Arabic", "count": 5 },
    { "code": "ur", "name": "Urdu", "count": 39 }
  ]
}