Skip to main content
POST
/
v1
/
voices
/
check_name_availability
Check Voice Name Availability
curl --request POST \
  --url https://api.bland.ai/v1/voices/check_name_availability \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "name": "<string>"
}
'
{
  "status": "success",
  "result": true,
  "message": "Voice name \"DocTestVoice\" is available"
}

​
Overview

Returns whether a proposed voice name is available in your org’s library. Use this to validate input before calling Clone Voice, which rejects the request outright if the name is taken. Names are scoped per org and case-insensitive.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Body Parameters

​
name
string
required
Voice name to check. 1-30 characters.

​
Response

​
status
string
success on success.
​
result
boolean
true if the name is available, false if it is already in use.
​
message
string
Human-readable confirmation.
{
  "status": "success",
  "result": true,
  "message": "Voice name \"DocTestVoice\" is available"
}
Docs for agents: llms.txt