Browse the docs

List voices

Lists narration voices: the user's own cloned voices first, then the popular voices, then the rest. Filter with search (name, accent, style), gender, language or mine. Pass a voice's id as voiceId.

Or open inClaude Code Codex Cursor Claude ChatGPT

Paste it into any AI assistant. The shortcuts open with the prompt typed in; nothing is sent until you press enter.

At a glance

Property	Value
REST	`GET https://api.clippie.ai/v1/voices`
MCP tool	`list_voices`
Scope	`read`
Cost	Free. Works with a read-only key.

REST
GET https://api.clippie.ai/v1/voices
MCP tool
list_voices
Scope
read
Cost
Free. Works with a read-only key.

Parameters

Name	In	Type	Required	Description
`search`	query	string	No	Matches name, accent or description, e.g. "british" or "deep". Up to 60 chars.
`gender`	query	string	No	One of `male`, `female`.
`language`	query	string	No	Language code, e.g. "en", "es", "jp". Up to 10 chars.
`mine`	query	boolean	No	Only the user's own cloned voices.
`limit`	query	integer	No	How many to return, 1-100. Default 25. 1-100.
`cursor`	query	string	No	`nextCursor` from the previous page. Up to 500 chars.

search
In:
query
Type:
string
Required:
No
Description:
Matches name, accent or description, e.g. "british" or "deep". Up to 60 chars.
gender
In:
query
Type:
string
Required:
No
Description:
One of male, female.
language
In:
query
Type:
string
Required:
No
Description:
Language code, e.g. "en", "es", "jp". Up to 10 chars.
mine
In:
query
Type:
boolean
Required:
No
Description:
Only the user's own cloned voices.
limit
In:
query
Type:
integer
Required:
No
Description:
How many to return, 1-100. Default 25. 1-100.
cursor
In:
query
Type:
string
Required:
No
Description:
nextCursor from the previous page. Up to 500 chars.

Example

curl

curl "https://api.clippie.ai/v1/voices?search=british&limit=10" \
  -H "Authorization: Bearer $CLIPPIE_API_KEY"

list-voices.mjs

const auth = { Authorization: `Bearer ${process.env.CLIPPIE_API_KEY}` };

const res = await fetch('https://api.clippie.ai/v1/voices?search=british&limit=10', { headers: auth });
if (!res.ok) throw new Error((await res.json()).error.message);
console.log(await res.json());

Response

200 { data, nextCursor }. Pass nextCursor as cursor for the next page. The item shape is in the OpenAPI spec.

From an MCP client

Your AI calls list_voices with the same fields as JSON arguments. See MCP server to connect one.

tools/call

{
  "name": "list_voices",
  "arguments": {
    "search": "british",
    "limit": 10
  }
}