List Voices | Resemble | Documentation

GET https://app.resemble.ai/api/v2/voices

Retrieve a paginated list of voices accessible to the user.

Parameter	Type	Required	Notes
`page`	integer	❌	Page number.
`page_size`	integer	❌	Items per page.
`pre_built_resemble_voice`	boolean	❌	Filter by pre-built voices.
`age`	string	❌	Filter by age (comma-separated values).
`gender`	string	❌	Filter by gender (comma-separated values).
`accents`	string	❌	Filter by accents (comma-separated values).
`use_case`	string	❌	Filter by use case (comma-separated values).
`tone_of_voice`	string	❌	Filter by tone (comma-separated values).
`advanced`	boolean	❌	Include advanced model information.
`sample_url`	boolean	❌	Include sample audio URLs.
`filters`	boolean	❌	Include filter metadata.
`voice_selector`	boolean	❌	Format for voice selector UI.

$ curl 'https://app.resemble.ai/api/v2/voices?page=1&page_size=10' \
>   -H 'Authorization: Bearer YOUR_API_TOKEN'

1 {
2   "success": true,
3   "page": 1,
4   "total_results": 10,
5   "page_count": 1,
6   "items": [
7     {
8       "uuid": "VOICE_UUID",
9       "name": "Production Voice",
10       "status": "ready",
11       "voice_status": "ready",
12       "voice_type": "professional",
13       "default_language": "en-US",
14       "supported_languages": ["en-US"],
15       "dataset_url": null,
16       "callback_uri": null,
17       "source": "Custom Voice",
18       "dataset_analysis_failure": false,
19       "component_status": {
20         "text_to_speech": { "status": "ready" },
21         "fill": { "status": "ready" },
22         "voice_conversion": { "status": "ready" }
23       },
24       "api_support": {
25         "sync_tts": true,
26         "async_tts": true,
27         "fill": true,
28         "sts": true
29       },
30       "created_at": "2024-01-15T10:30:00Z",
31       "updated_at": "2024-01-15T10:32:00Z"
32     }
33   ]
34 }