Get Voices

Browse and filter the Tabbly voice library. 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 in the Authorization: Bearer header.

Authorization: Bearer YOUR_API_KEY

Query parameters

Case-sensitive filters: Values must match the voice library exactly (Female not female, en not english). A typo or wrong casing returns count: 0 — call without filters first and copy values from the voices response.

Example request

curl -G "https://www.tabbly.io/api/get-voices" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "gender=Female" \
  --data-urlencode "language=en"

Response

Success (200)

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

Each voice object includes pricing (per_min_price), language metadata, and the id you pass to Create Agent.

Error responses