1. Voices
VoiceDock
  • System
    • Health check
      GET
  • Organization
    • Get organization information
      GET
    • Create organization
      POST
    • Get organization information (deprecated)
      GET
  • Assistants
    • List all assistants
      GET
    • Create a new assistant
      POST
    • Get an assistant
      GET
    • Update an assistant
      PATCH
    • Delete an assistant
      DELETE
  • Numbers
    • List all phone numbers
      GET
    • Register a phone number
      POST
    • Get a phone number
      GET
    • Update a phone number
      PATCH
    • Delete a phone number
      DELETE
  • Calls
    • List calls
      GET
    • Get call by ID
      GET
    • Initiate outbound call
      POST
  • Call Control
    • Send control command to active call
      POST
  • Usage
    • Get usage logs
      GET
  • SIP Trunks
    • List SIP trunks
      GET
    • Create a SIP trunk
      POST
    • Get a SIP trunk
      GET
    • Delete a SIP trunk
      DELETE
  • Voices
    • List available voices
      GET
  • BYOK
    • Get BYOK configurations
    • Add BYOK configuration
    • Delete BYOK configuration
    • Get BYOK provider configurations
  • Domains
    • Get your domain
    • Add a domain
    • Delete your domain
    • List available Resend domains
    • Select and sync a Resend domain
    • Verify domain DNS records
    • Refresh domain status
  • Tool Templates
    • List all tool templates
    • Create a new tool template
    • Get a tool template
    • Update a tool template
    • Delete a tool template
  • Analysis Templates
    • List analysis templates
    • Create analysis template
    • Get analysis template
    • Update analysis template
    • Delete analysis template
  • Campaigns
    • List all campaigns
    • Create a campaign
    • Get a campaign
    • Update a campaign
    • Delete a campaign
    • List campaign leads
    • Add a lead
    • Remove a lead
  • Chats
    • Append a chat message
    • List chat messages
    • Delete a chat message
    • Get conversation context for a contact
  • Webhooks
    • Dynamic assistant configuration webhook
    • Tool/Function Call
    • Call Status Update
    • End of Call Report
  • Schemas
    • OrganizationChild
    • Organization
    • Error
    • OrganizationCreate
    • OrganizationCreated
    • AnalysisPlan
    • STTConfig
    • ToolDefinition
    • LLMConfig
    • TTSConfig
    • Agent
    • AgentCreate
    • SuccessResponse
    • AgentUpdate
    • PhoneNumber
    • PhoneNumberCreate
    • PhoneNumberUpdate
    • Call
    • Pagination
    • AssistantConfigOverride
    • OutboundCallRequest
    • OutboundCallResponse
    • InjectContextCommand
    • SayCommand
    • EndCallCommand
    • TransferCommand
    • CallControlCommand
    • CallControlResponse
    • UsageLog
    • UsageSummary
    • SipTrunk
    • SipTrunkCreate
    • Voice
    • ToolTemplate
    • ToolTemplateCreate
    • ToolTemplateUpdate
    • AnalysisTemplate
    • AnalysisTemplateListResponse
    • CreateAnalysisTemplate
    • UpdateAnalysisTemplate
    • Campaign
    • CampaignCreate
    • CampaignUpdate
    • CampaignLead
    • CampaignLeadCreate
    • ChatMessage
    • ChatMessageCreate
    • ChatContext
    • CallObject
    • Customer
    • AssistantRequestPayload
    • AssistantRequestResponse
    • AssistantWebhookObject
    • ToolCall
    • ToolCallsPayload
    • ToolCallsResponse
    • StatusUpdatePayload
    • EndOfCallReportPayload
Book a meeting
Linkedin
Github
📄 Documentation🔌 API Reference
🤖 MCP📦 SDK🟢 Status
📄 Documentation🔌 API Reference
🤖 MCP📦 SDK🟢 Status
  1. Voices

List available voices

GET
https://api.hmsovereign.com/api/v1/voices
Voices
Last modified:2026-05-04 13:09:49
Maintainer:Not configured
Returns available voices for your agents.

Voice Providers#

Local Voices (All Users)#

Local voices are lightweight, fast, and cost-effective. They provide clear, slightly robotic speech that works well for transactional calls like appointments, surveys, and customer service.
This endpoint returns all available local voices grouped by language. Over 90 voices across 35+ languages are available.

ElevenLabs (BYOK)#

This endpoint does NOT return ElevenLabs voices. Check your ElevenLabs Voice Library at https://elevenlabs.io/app/voice-library for available voices when using your own API key.
Available ElevenLabs models: eleven_flash_v2_5 (fastest, default), eleven_v3 (expressive dialogue with audio tags - supports [emotion] cues in square brackets), eleven_multilingual_v2 (best quality), eleven_turbo_v2_5 (balanced), eleven_monolingual_v1 (English only).

xAI Grok Realtime (BYOK)#

Grok Realtime has built-in voices (not returned by this endpoint). Set voice via llm_config.voice when creating/updating an agent.
Available xAI voices: ara, rex, sal, eve, leo

Choosing the Right Voice#

Use CaseRecommended
Appointments, surveys, supportLocal voices (fast, clear)
Sales, relationship-buildingElevenLabs (natural, expressive)
Real-time conversationsxAI Grok Realtime (low latency)
Example agent with local voice:
{
  "name": "Appointment Agent",
  "tts_config": {
    "provider": "local",
    "voice_id": "nl_NL-pim-medium",
    "language": "nl"
  }
}

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or

Responses

🟢200OK
application/json
List of available voices
Body

🟠401Unauthorized
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.hmsovereign.com/api/v1/voices' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Example 1
{
    "voices": [
        {
            "id": "nl_NL-pim-medium",
            "name": "Pim",
            "language": "nl",
            "description": {
                "en": "Pim (Dutch, Male)",
                "nl": "Pim (Nederlands, Man)"
            },
            "provider": "local"
        }
    ],
    "xai_realtime_voices": [
        {
            "id": "ara",
            "name": "Ara",
            "style": "Female, professional"
        },
        {
            "id": "rex",
            "name": "Rex",
            "style": "Male, friendly"
        },
        {
            "id": "sal",
            "name": "Sal",
            "style": "Neutral, calm"
        },
        {
            "id": "eve",
            "name": "Eve",
            "style": "Female, warm"
        },
        {
            "id": "leo",
            "name": "Leo",
            "style": "Male, energetic"
        }
    ]
}
Modified at 2026-05-04 13:09:49
Previous
Delete a SIP trunk
Next
Get BYOK configurations
Built with