Get Voices

Lists available AI voices you can assign when creating an agent. Use this endpoint to find a voice_id before Create Agent.

Endpoint

GET https://www.tabbly.io/api/get-voices

Authentication

See Introduction. This is a GET endpoint. Send your API key using one of:

X-API-Key: YOUR_API_KEY

Or as a query parameter:

GET /api/get-voices?api_key=YOUR_API_KEY

Query parameters

Parameter	Type	Required	Description
`api_key`	string	Yes*	Your API key (if not sent via `X-API-Key` header)
`gender`	string	No	Filter by gender (e.g. `Female`, `Male`). Matching is case-insensitive in practice
`language`	string	No	Filter by language. Must match a value returned by this API exactly (e.g. `en` and `english` are different)
`accent`	string	No	Filter by accent. Must match a value returned by this API exactly (casing may vary, e.g. `Indian` vs `indian`)
`cloned`	string	No	Set to `yes` to return cloned voices only

Example request

curl -G "https://www.tabbly.io/api/get-voices" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "gender=Female" \
  --data-urlencode "language=english"

Response

Success (200)

{
  "status": "success",
  "count": 1,
  "voices": [
    {
      "id": 125,
      "name": "Ara",
      "audio_url": null,
      "language": "english",
      "gender": "Female",
      "accent": "american",
      "cloned": "no",
      "created_at": "2026-03-24 15:55:12"
    }
  ]
}

Field	Type	Description
`id`	integer	Voice library ID — pass to Create Agent
`language`	string	Stored language value (not normalized to ISO codes)

Error responses

{
  "error": "API key is required"
}

HTTP status	When
400	Missing API key
401	Invalid API key
500	Server or database error

Notes

Call without filters first, then copy exact language, gender, and accent values from the voices response. language is stored as-is in the database — en and english are different filters. gender matching is case-insensitive in practice. accent values may vary in casing (Indian vs indian).