List shared voices

GET

/v1/shared-voices

GET

/v1/shared-voices

$ curl https://api.elevenlabs.io/v1/shared-voices

1 {
2   "voices": [
3     {
4       "public_owner_id": "63e84100a6bf7874ba37a1bab9a31828a379ec94b891b401653b655c5110880f",
5       "voice_id": "sB1b5zUrxQVAFl2PhZFp",
6       "date_unix": 1714423232,
7       "name": "Alita",
8       "accent": "american",
9       "gender": "Female",
10       "age": "young",
11       "descriptive": "calm",
12       "use_case": "characters_animation",
13       "category": "professional",
14       "usage_character_count_1y": 12852,
15       "usage_character_count_7d": 12852,
16       "play_api_usage_character_count_1y": 12852,
17       "cloned_by_count": 11,
18       "free_users_allowed": true,
19       "live_moderation_enabled": false,
20       "featured": false,
21       "language": "en",
22       "description": "Perfectly calm, neutral and strong voice. Great for a young female protagonist.",
23       "preview_url": "https://storage.googleapis.com/eleven-public-prod/wqkMCd9huxXHX1dy5mLJn4QEQHj1/voices/sB1b5zUrxQVAFl2PhZFp/55e71aac-5cb7-4b3d-8241-429388160509.mp3",
24       "rate": 1,
25       "verified_languages": [
26         {
27           "language": "en",
28           "model_id": "eleven_multilingual_v2",
29           "accent": "american",
30           "locale": "en-US",
31           "preview_url": "https://storage.googleapis.com/eleven-public-prod/wqkMCd9huxXHX1dy5mLJn4QEQHj1/voices/sB1b5zUrxQVAFl2PhZFp/55e71aac-5cb7-4b3d-8241-429388160509.mp3"
32         }
33       ]
34     }
35   ],
36   "has_more": false,
37   "total_count": 0
38 }

Retrieves a list of shared voices.

Query parameters

page_sizeintegerOptionalDefaults to 30

How many shared voices to return at maximum. Can not exceed 100, defaults to 30.

categoryenumOptional

Voice category used for filtering

Allowed values:

genderstring or nullOptional

Gender used for filtering

agestring or nullOptional

Age used for filtering

accentstring or nullOptional

Accent used for filtering

languagestring or nullOptional

Language used for filtering

localestring or nullOptional

Locale used for filtering

searchstring or nullOptional

Search term used for filtering

use_caseslist of strings or nullOptional

Use-case used for filtering

descriptiveslist of strings or nullOptional

Search term used for filtering

featuredbooleanOptionalDefaults to false

Filter featured voices

min_notice_period_daysinteger or nullOptional

Filter voices with a minimum notice period of the given number of days.

include_custom_ratesboolean or nullOptional

Include/exclude voices with custom rates

include_live_moderatedboolean or nullOptional

Include/exclude voices that are live moderated

reader_app_enabledbooleanOptionalDefaults to false

Filter voices that are enabled for the reader app

owner_idstring or nullOptional

Filter voices by public owner ID

sortenumOptionalDefaults to created_date

Sort criteria. Must be one of: created_date, usage_character_count_1y, trending, cloned_by_count.

Allowed values:

pageintegerOptionalDefaults to 0

Response

Successful Response

voiceslist of objects

The list of shared voices

has_moreboolean

Whether there are more shared voices in subsequent pages.

total_countintegerDefaults to 0

The total number of shared voices matching the query.

last_sort_idstring or null

Errors

422

Unprocessable Entity Error

Headers

Query parameters

Response

Errors