Skip to main content
GET
/
voices
/
v1
/
voices
cURL
curl --location 'https://api.inworld.ai/voices/v1/voices?languages=EN_US' \
--header "Authorization: Basic $INWORLD_API_KEY"
{
  "voices": [
    {
      "name": "Alex",
      "langCode": "EN_US",
      "displayName": "Alex",
      "description": "Energetic and expressive mid-range male voice, with a mildly nasal quality",
      "tags": [
        "friendly",
        "expressive"
      ],
      "voiceId": "Alex",
      "source": "SYSTEM"
    },
    {
      "name": "Darlene",
      "langCode": "EN_US",
      "displayName": "Darlene",
      "description": "Soothing, comforting Southern female voice, ideal for bedtime stories, family-centered commercials, and nostalgic narrations.",
      "tags": [
        "soothing",
        "comforting",
        "gentle",
        "southern"
      ],
      "voiceId": "Darlene",
      "source": "SYSTEM"
    },
    {
      "name": "workspaces/your_workspace_id/voices/my_voice_clone_demo_20260218_223134z",
      "langCode": "EN_US",
      "displayName": "John",
      "description": "Cloned voice for narrations.",
      "tags": [
        "demo",
        "clone"
      ],
      "voiceId": "your_workspace_id__my_voice_clone_demo_20260218_223134z",
      "source": "IVC"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.inworld.ai/llms.txt

Use this file to discover all available pages before exploring further.

Short URL Path: /workspaces/{workspace} is no longer required in the path for simplicity and clarity. When omitted, the workspace is derived from your API key. The previous URL with the full path /voices/v1/workspaces/{workspace}/voices would continue to be supported.
Want to hear how a voice sounds? Use the Get voice preview endpoint to listen to a short audio sample of any voice — free and unbilled.

Authorizations

​
Authorization
string
header
required

Your API key. Read permissions are required for GET endpoints. Write permissions are required for POST, PATCH, and DELETE endpoints.

For Basic authentication, please populate Basic $INWORLD_API_KEY

Query Parameters

​
languages
string[]

Optional language filter for union filtering (voices matching ANY of the specified languages) Supported formats: EN_US or en. Example: ?languages=EN_US&languages=es returns voices in either English or Spanish

Response

A successful response.

Response message for ListVoices.

​
voices
List of voices · object[]