DocumentationAPI Reference
DocumentationAPI Reference
Book a meeting
Linkedin
Github
  1. Voices
  • Agents
    • List all agents
      GET
    • Create a new agent
      POST
    • Get an agent
      GET
    • Update an agent
      PATCH
    • Delete an agent
      DELETE
  • Tool Templates
    • List all tool templates
      GET
    • Create a new tool template
      POST
    • Get a tool template
      GET
    • Update a tool template
      PATCH
    • Delete a tool template
      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
  • Webhooks
    • Dynamic assistant configuration webhook
    • Tool/Function Call
    • Call Status Update
    • End of Call Report
  • Analysis Templates
    • List analysis templates
    • Create analysis template
    • Get analysis template
    • Update analysis template
    • Delete analysis template
  • Organization
    • Get organization information
    • Create organization
    • Get organization information (deprecated)
  • 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
  • Schemas
    • Error
    • Pagination
    • UUID
    • Timestamp
    • SuccessResponse
    • STTConfig
    • LLMConfig
    • TTSConfig
    • XAIRealtimeConfig
    • Agent
    • AgentCreate
    • AgentUpdate
    • PhoneNumber
    • PhoneNumberCreate
    • PhoneNumberUpdate
    • Call
    • CallControlCommand
    • InjectContextCommand
    • SayCommand
    • EndCallCommand
    • TransferCommand
    • CallControlResponse
    • OutboundCallRequest
    • Account
    • UsageLog
    • OutboundCallResponse
    • UsageSummary
    • Organization
    • SipTrunk
    • SipTrunkCreate
    • OrganizationChild
    • Voice
    • OrganizationCreate
    • OrganizationCreated
    • AssistantRequestPayload
    • CallObject
    • Customer
    • AssistantRequestResponse
    • XAIRealtimeVoice
    • AssistantConfigOverride
    • AnalysisPlan
    • AssistantWebhookObject
    • ToolCallsPayload
    • ToolCall
    • ToolCallsResponse
    • StatusUpdatePayload
    • EndOfCallReportPayload
    • ToolDefinition
    • EndCallTool
    • TransferCallTool
    • WebhookHeaders
    • XAIRealtimeWebhookNotes
    • ToolFunctionConfig
    • ToolTransferConfig
    • ToolTemplate
    • ToolTemplateCreate
    • ToolTemplateUpdate
    • AnalysisTemplate
    • CreateAnalysisTemplate
    • UpdateAnalysisTemplate
    • AnalysisTemplateListResponse
    • CampaignLead
    • Campaign
    • CampaignCreate
    • CampaignUpdate
    • CampaignLeadCreate
DocumentationAPI Reference
DocumentationAPI Reference
Book a meeting
Linkedin
Github
  1. Voices

List available voices

GET
https://api.hmsovereign.com/api/v1/voices
Voices
Last modified:2026-01-30 13:43:45
Maintainer:Jesper Rietbergen
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.

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
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************

Responses

🟢200
application/json
List of available voices
Body

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
{
    "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-01-30 13:43:45
Previous
Delete a SIP trunk
Next
Get BYOK configurations
Built with