> ## Documentation Index
> Fetch the complete documentation index at: https://www.voiceflow.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Search voices

> Search the ElevenLabs and Cartesia voice catalog.



## OpenAPI

````yaml /specs-prettified/realtime/openapi.stable.json get /v1/stable/agent/voice-catalog
openapi: 3.0.0
info:
  title: Realtime
  description: Realtime gateway API service
  version: 1.0.0
  contact: {}
servers:
  - url: https://realtime-api.voiceflow.com
security: []
tags: []
paths:
  /v1/stable/agent/voice-catalog:
    get:
      tags:
        - Agent
      summary: Search voices
      description: Search the ElevenLabs and Cartesia voice catalog.
      operationId: StableAgentController_searchVoices
      parameters:
        - name: projectID
          required: true
          in: query
          schema:
            type: string
            description: The ID of the project to operate on.
        - name: search
          required: false
          in: query
          schema:
            description: 'Words to find in the name, description or accent, or one whole
              voice ID. Every word must match, ignoring case: "vikram" or "calm
              british".'
            type: string
            minLength: 1
            maxLength: 200
        - name: language
          required: false
          in: query
          schema:
            description: 'Only voices that speak this language: a language ("hi") or a
              language and region ("en-IN"). Native speakers come first, and
              with a region those native to it before the rest.'
            type: string
            minLength: 2
            maxLength: 35
        - name: provider
          required: false
          in: query
          schema:
            allOf:
              - $ref: "#/components/schemas/StableCatalogVoiceProvider"
        - name: gender
          required: false
          in: query
          schema:
            allOf:
              - $ref: "#/components/schemas/StableCatalogVoiceGender"
        - name: limit
          required: false
          in: query
          schema:
            default: 10
            description: The most voices to return in one page.
            type: integer
            minimum: 1
            maximum: 25
        - name: offset
          required: false
          in: query
          schema:
            default: 0
            description: "How many matching voices to skip: nextOffset from the previous
              page."
            type: integer
            minimum: 0
            maximum: 9007199254740991
      responses:
        "200":
          description: ""
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StableVoiceCatalogSearchResponse"
      security:
        - token: []
components:
  schemas:
    StableCatalogVoiceProvider:
      type: string
      enum:
        - elevenlabs
        - cartesia
      description: A TTS provider whose voices are in the voice catalog.
      x-enumNames:
        - ELEVENLABS
        - CARTESIA
    StableCatalogVoiceGender:
      type: string
      enum:
        - male
        - female
        - neutral
      description: How the vendor describes the voice.
      x-enumNames:
        - MALE
        - FEMALE
        - NEUTRAL
    StableVoiceCatalogSearchResponse:
      type: object
      properties:
        voices:
          type: array
          items:
            $ref: "#/components/schemas/StableCatalogVoice"
          description: This page of the matching voices, best match first.
        total:
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
          description: How many voices match, across every page.
        nextOffset:
          nullable: true
          description: The offset of the next page, or null when this page reaches the
            last match.
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
      required:
        - voices
        - total
        - nextOffset
    StableCatalogVoice:
      type: object
      properties:
        provider:
          $ref: "#/components/schemas/StableCatalogVoiceProvider"
        voiceID:
          type: string
          description: The ID to pick the voice with.
        name:
          type: string
        gender:
          nullable: true
          allOf:
            - $ref: "#/components/schemas/StableCatalogVoiceGender"
        accent:
          nullable: true
          type: string
        description:
          nullable: true
          description: The vendor's description, cut to 200 characters.
          type: string
        nativeLanguages:
          type: array
          items:
            type: string
          description: 'The languages the voice is native in: a language and region where
            the catalog gives one ("en-IN"), else a language ("hi").'
        otherLanguages:
          type: array
          items:
            type: string
          description: Other languages the voice can speak, as language codes.
        featured:
          type: boolean
          description: The vendor recommends the voice for one of its languages.
        previewURL:
          nullable: true
          description: "A link to an audio sample, for the user to hear the voice: in the
            language asked for when the catalog has one, else in the voice's own
            language."
          type: string
      required:
        - provider
        - voiceID
        - name
        - gender
        - accent
        - description
        - nativeLanguages
        - otherLanguages
        - featured
        - previewURL
  securitySchemes:
    token:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Voiceflow bearer token
````