Skip to main content
GET
/
agent
/
voices
Get Assistant Voices
curl --request GET \
  --url https://prod-api.ringg.ai/ca/api/v0/agent/voices \
  --header 'X-API-KEY: <x-api-key>'
{
  "voices": [
    {
      "id": "3b5c7d2a-8e9f-4a1b-9c6d-2e5f8a7b3c4d",
      "name": "Sarah",
      "languages": [
        "en-US",
        "en-GB"
      ],
      "voice_previews": {
        "en-US": "https://example.com/voice-preview-en-us.mp3"
      },
      "image_url": "https://example.com/voice-avatar.jpg",
      "gender": "female",
      "created_at": "2024-12-16T13:03:29.947147+00:00",
      "updated_at": "2024-12-16T13:03:29.947147+00:00"
    }
  ]
}
List available voices for assistant configuration. You can optionally filter by language when building assistant creation or configuration workflows.

​
When to use

  • Populate a voice picker in a custom assistant setup UI.
  • Validate that a desired language has available voices before creating an assistant.
  • Let internal operators compare voice options without opening the Ringg dashboard.

​
Integration notes

Voice availability can vary by language and provider. Store the selected voice ID only after the operator confirms the assistant configuration.

Headers

​
X-API-KEY
string
required

(Required) Your Ringg AI API key.

Example:

"7251cb4b-3373-43a4-844c-b27a1d45e0c9"

Query Parameters

​
language
string

Filter voices by language (e.g., 'en-US', 'hi-IN'). Multiple languages can be comma-separated.

Response

Successful Response: A list of available voices.

​
voices
object[]