---
title: "Search voice library"
method: POST
path: "/organization/voice_library"
tags: ["Voices"]
---

# Search voice library

`POST /organization/voice_library`

## Request

- Base URL: `https://api.beyondwords.io/v1`
- URL: `https://api.beyondwords.io/v1/organization/voice_library`
- Auth: API key in header `X-Api-Key`

Lists voices available to your organization with filtering, ordering and pagination.

## Request body

- RequestBodyVoiceLibrary
  - `filter` object
    - `ids` integer[]: Only return voices with these IDs
    - `name` string: Case-insensitive partial match on the voice name
    - `language` object
      - `code` string: Language code
    - `origin` 'native' | 'non-native': Applies to language.code. native - match the primary language only, non-native - match secondary languages only, omitted - match any language
    - `genders` string[]: none matches voices without a gender
    - `types` string[]
    - `statuses` string[]
    - `previewStatuses` string[]: Preview status for the voice's primary language. Defaults to [processed]
    - `additional` boolean: false excludes additional voices
    - `custom` boolean: true returns only custom voices, false excludes them
  - `order` object
    - `by` 'type' | 'created': type orders premade, generated, instant, professional
    - `dir` 'asc' | 'desc'
  - `pagination` object
    - `offset` integer
    - `limit` integer, nullable: Defaults to 20 when pagination or limit is omitted. An explicit null returns all voices from offset, without a limit

## Response `200`

OK

- VoiceModel[]
  - `id` integer: Unique identifier for the object
  - `name` string: The name of the voice
  - `type` 'premade' | 'instant' | 'professional' | 'generated': The type of the voice
  - `status` 'draft' | 'recording' | 'processing' | 'review' | 'enabled' | 'deprecated' | 'disabled' | 'unavailable': The status of the voice
  - `preview_statuses` 'processing' | 'processed': The preview status of the voice for its primary language
  - `speaker` object, nullable: The speaker of the voice
    - `id` integer: Unique identifier for the object
    - `first_name` string: The first name of the speaker
    - `last_name` string: The last name of the speaker
    - `image_url` string, nullable: The image URL of the speaker
    - `created` string, date-time: Time at which the object was created (ISO 8601)
    - `updated` string, date-time: Time at which the object was updated (ISO 8601)
  - `script_ids` integer[]: The script IDs associated with the voice
  - `speaking_rate` integer: The speaking rate of the voice
  - `multilingual_mode` boolean
  - `expressiveness` number, nullable
  - `use_speaker_boost` boolean, nullable
  - `similarity_boost` number, nullable
  - `style` number, nullable
  - `clone_strength` number, nullable: Only applied to ElevenLabs professional voice clones on eleven_v4 / eleven_v4_turbo
  - `languages` object[]: The languages supported by the voice
    - `code` string: The ISO 639-1 code of the language
    - `name` string: The name of the language
    - `accent` string, nullable: The accent of the language
    - `preview_url` string, nullable: The preview URL of the language
  - `cloning_consent` string, nullable: The cloning consent URL for instant and professional voices
  - `clone_errors` object[]: An array of voice cloning errors in the standard error format
  - `created` string, date-time: Time at which the object was created (ISO 8601)
  - `updated` string, date-time: Time at which the object was updated (ISO 8601)
  - `logo_pattern` integer, nullable: Logo pattern number
  - `logo_color` 'red' | 'green' | 'blue' | 'purple' | 'gray' | 'pink' | 'cyan', nullable: Logo pattern color
  - `gender` 'male' | 'female' | 'neutral', nullable: The gender of the voice
  - `language` string: The language of the voice
  - `secondary_languages` string[]: The secondary languages of the voice
  - `service` string: The source of the voice
  - `model_id` string, nullable
  - `expected_model_ids` string[], nullable: Model IDs the voice will be available for once cloning finishes. Only present while the voice is recording or processing
  - `preview_url` string, nullable: The preview URL of the voice
  - `premium` boolean: Whether the voice is premium or not
  - `exclusive` boolean: Whether the voice is exclusive or not
  - `custom` boolean: The custom flag of the voice
  - `additional` boolean
  - `pauses_supported` boolean
  - `clone_strength_supported` boolean: Whether the clone_strength voice setting is applied for this voice

## Changes

- **2026-11-03** `994b9853e685`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api/changes/organization/voice_library/post.md)

---

[API](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api.md) - [All operations](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api/revisions/994b9853e685?raw)