---
title: "Get Voices"
method: GET
path: "/v1/shared-voices"
tags: ["voices"]
---

# Get Voices

`GET /v1/shared-voices`

Retrieves a list of shared voices.

## Query parameters

- `page_size` integer — How many shared voices to return at maximum. Can not exceed 100, defaults to 30.
- `category` 'professional' | 'famous' | 'high_quality', nullable — Voice category used for filtering
- `gender` string, nullable — Gender used for filtering
- `age` string, nullable — Age used for filtering
- `accent` string, nullable — Accent used for filtering
- `language` string, nullable — Language used for filtering
- `locale` string, nullable — Locale used for filtering
- `search` string, nullable — Search term used for filtering
- `use_cases` string[], nullable — Use-case used for filtering
- `descriptives` string[], nullable — Search term used for filtering
- `featured` boolean — Filter featured voices
- `min_notice_period_days` integer, nullable — Filter voices with a minimum notice period of the given number of days.
- `include_custom_rates` boolean, nullable — Include/exclude voices with custom rates
- `include_live_moderated` boolean, nullable — Include/exclude voices that are live moderated
- `reader_app_enabled` boolean — Filter voices that are enabled for the reader app
- `owner_id` string, nullable — Filter voices by public owner ID
- `sort` 'created_date' | 'usage_character_count_1y' | 'trending' | 'cloned_by_count', nullable — Sort criteria. Must be one of: created_date, usage_character_count_1y, trending, cloned_by_count.
- `page` integer

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- GetLibraryVoicesResponseModel
  - `voices` LibraryVoiceResponseModel[], required — The list of shared voices
    - `public_owner_id` string, required — The public owner id of the voice.
    - `voice_id` string, required — The id of the voice.
    - `date_unix` integer, required — The date the voice was added to the library in Unix time.
    - `name` string, required — The name of the voice.
    - `accent` string, required — The accent of the voice.
    - `gender` string, required — The gender of the voice.
    - `age` string, required — The age of the voice.
    - `descriptive` string, required — The descriptive of the voice.
    - `use_case` string, required — The use case of the voice.
    - `category` 'generated' | 'cloned' | 'premade' | 'professional' | 'famous' | 'high_quality', required — The category of the voice.
    - `language` string, nullable — The language of the voice.
    - `locale` string, nullable — The locale of the voice.
    - `description` string, nullable — The description of the voice.
    - `preview_url` string, nullable — The preview URL of the voice.
    - `usage_character_count_1y` integer, required — The usage character count of the voice in the last year.
    - `usage_character_count_7d` integer, required — The usage character count of the voice in the last 7 days.
    - `play_api_usage_character_count_1y` integer, required — The play API usage character count of the voice in the last year.
    - `cloned_by_count` integer, required — The number of times the voice has been cloned.
    - `rate` number, nullable — The rate multiplier of the voice.
    - `fiat_rate` number, nullable — The rate of the voice in USD per 1000 credits. null if default
    - `free_users_allowed` boolean, required — Whether free users are allowed to use the voice.
    - `live_moderation_enabled` boolean, required — Whether live moderation is enabled for the voice.
    - `featured` boolean, required — Whether the voice is featured.
    - `verified_languages` VerifiedVoiceLanguageResponseModel[], nullable — The verified languages of the voice.
      - `language` string, required — The language of the voice.
      - `model_id` string, required — The voice's model ID.
      - `accent` string, nullable — The voice's accent, if applicable.
      - `locale` string, nullable — The voice's locale, if applicable.
      - `preview_url` string, nullable — The voice's preview URL, if applicable.
    - `notice_period` integer, nullable — The notice period of the voice.
    - `instagram_username` string, nullable — The Instagram username of the voice.
    - `twitter_username` string, nullable — The Twitter username of the voice.
    - `youtube_username` string, nullable — The YouTube username of the voice.
    - `tiktok_username` string, nullable — The TikTok username of the voice.
    - `image_url` string, nullable — The image URL of the voice.
    - `is_added_by_user` boolean, nullable — Whether the voice was added by the user.
    - `is_bookmarked` boolean, nullable — Whether the voice is bookmarked by the current user. Only relevant when is_added_by_user is True.
  - `has_more` boolean, required — Whether there are more shared voices in subsequent pages.
  - `total_count` integer — The total number of shared voices matching the query.
  - `last_sort_id` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/versions/e77a0a530a82/schema)