Skip to content

List Voices

FreshGET
GET https://api.creatify.ai/api/voices/

Retrieve the full list of all available voices. This includes built-in voices across multiple languages and accents.

Headers

HeaderTypeRequiredDescription
X-API-IDstringYesYour Creatify API ID
X-API-KEYstringYesYour Creatify API key

Example Request

bash
curl -X GET 'https://api.creatify.ai/api/voices/' \
  -H 'X-API-ID: your-api-id' \
  -H 'X-API-KEY: your-api-key'

Response

json
[
  {
    "id": "voice-en-001",
    "name": "Sarah",
    "language": "en",
    "accent": "American",
    "gender": "female",
    "preview_url": "https://cdn.creatify.ai/voices/sarah-preview.mp3"
  },
  {
    "id": "voice-en-002",
    "name": "James",
    "language": "en",
    "accent": "British",
    "gender": "male",
    "preview_url": "https://cdn.creatify.ai/voices/james-preview.mp3"
  }
]

Response Fields

FieldTypeDescription
idstringUnique voice identifier (use this in other API calls)
namestringHuman-readable voice name
languagestringLanguage code
accentstringAccent or dialect
genderstringVoice gender
preview_urlstringURL to a sample audio clip

Status Codes

CodeDescription
200Success
401Unauthorized -- invalid API credentials
429Rate limit exceeded
500Internal server error

TIP

Use the id field from this response as the voice_id parameter in avatar creation, text-to-speech, and other endpoints that accept a voice selection.