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

# List Voices

> Get a list of all pre-built voices.



## OpenAPI

````yaml GET /api/v1/voices
openapi: 3.1.0
info:
  title: PlayAI API
  version: 1.0.0
  description: |
    A single, combined OpenAPI specification that merges:
      • PlayAI Agent API
      • PlayAI PlayNote API
      • PlayAI Text-to-Speech (TTS) API
      • PlayAI Dialog Turbo API

    This file contains all endpoints, schemas, and components 
    from the four original specs. See "Merged Issues" below 
    for notes on how certain conflicts were resolved.
servers:
  - url: https://api.play.ai
security:
  - ApiKeyAuth: []
    XUserIdAuth: []
paths:
  /api/v1/voices:
    get:
      description: |
        Get a list of all pre-built voices.
      parameters:
        - name: search
          in: query
          description: A search query to filter the voices by name.
          required: false
          example: brandon
          schema:
            type: string
            nullable: true
      responses:
        '200':
          description: A list of all pre-built voices.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Voice'
components:
  schemas:
    Voice:
      type: object
      required:
        - name
        - id
        - sample
        - gender
        - accent
        - description
        - language
        - tags
        - categories
        - updatedDate
        - createdDate
      properties:
        name:
          type: string
          example: Jun Conversational
        id:
          type: string
          example: s3://voice-cloning-zero-shot/00325021.../manifest.json
        sample:
          type: string
          format: uri
        gender:
          type: string
          enum:
            - male
            - female
        accent:
          type: string
        description:
          type: string
        language:
          oneOf:
            - type: string
              enum:
                - afrikaans
                - albanian
                - amharic
                - arabic
                - bengali
                - bulgarian
                - catalan
                - croatian
                - czech
                - danish
                - dutch
                - english
                - french
                - galician
                - german
                - greek
                - hebrew
                - hindi
                - hungarian
                - indonesian
                - italian
                - japanese
                - korean
                - malay
                - mandarin
                - polish
                - portuguese
                - russian
                - serbian
                - spanish
                - swedish
                - tagalog
                - thai
                - turkish
                - ukrainian
                - urdu
                - xhosa
        tags:
          type: array
          items:
            type: string
        categories:
          type: array
          items:
            type: string
        updatedDate:
          type: number
        createdDate:
          type: number
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      description: >
        Your secret API key from [PlayAI](https://play.ai/api/keys), formatted
        as `Bearer YOUR_SECRET_API_KEY`.
    XUserIdAuth:
      type: apiKey
      in: header
      name: X-USER-ID
      description: |
        Your unique user ID from [PlayAI](https://play.ai/api/keys).
      x-prompt: What is your PlayAI user ID?

````