# Get Voices (Batch)

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /voices/batch:
    post:
      summary: Get Voices (Batch)
      deprecated: false
      description: Get voices from the voice libarary using list of voice ids
      tags:
        - API Reference/Voice Management
      parameters:
        - name: x-api-key
          in: header
          description: ''
          required: true
          example: <api-key>
          schema:
            type: string
        - name: version
          in: header
          description: ''
          required: true
          example: v1
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                voice_ids:
                  type: array
                  items:
                    type: string
              required:
                - voice_ids
              x-apidog-orders:
                - voice_ids
            example:
              voice_ids:
                - e0f39dc4-f691-4e78-bba5-5c636692cc04
                - e0f39dc4-f691-4e78-bba5-5c636692cc04
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    voice_id:
                      type: string
                      description: Voice id
                    name:
                      type: string
                      description: Voice name
                    description:
                      type: string
                      description: Voice description
                    language:
                      type: string
                      description: Voice language(s) (ISO 639-1), comma-separated
                      examples:
                        - de,en,es,fr,it
                    gender:
                      type: string
                      description: Voice gender
                      enum:
                        - Male
                        - Female
                        - Neutral
                        - Unspecified
                      x-apidog-enum:
                        - value: Male
                          name: ''
                          description: ''
                        - value: Female
                          name: ''
                          description: ''
                        - value: Neutral
                          name: ''
                          description: ''
                        - value: Unspecified
                          name: ''
                          description: ''
                    accent:
                      type: string
                      description: Voice accent
                    style:
                      type: string
                      description: Voice style(s), comma-separated
                    created_at:
                      type: string
                      description: Voice creation datetime
                    updated_at:
                      type: string
                      description: Voice update datetime
                    voice_type:
                      type: string
                      description: Whether the voice is owned by the current user
                      enum:
                        - PREDEFINED
                        - CUSTOM
                      x-apidog-enum:
                        - value: PREDEFINED
                          name: ''
                          description: stock voice
                        - value: CUSTOM
                          name: ''
                          description: custom cloned voice
                  x-apidog-orders:
                    - voice_id
                    - name
                    - description
                    - language
                    - gender
                    - accent
                    - style
                    - created_at
                    - updated_at
                    - voice_type
                  required:
                    - voice_id
                    - name
                    - description
                    - language
                    - gender
                    - accent
                    - created_at
                    - updated_at
                    - voice_type
                    - style
              example:
                - voice_id: d4g7a640-44
                  name: Name
                  description: Description
                  language: en
                  accent: American (US)
                  style: Storytelling
                  gender: Male
                  created_at: '2025-05-19T14:37:07.297056'
                  updated_at: '2025-05-19T14:37:07.297056'
                  voice_type: PREDEFINED
          headers: {}
          x-apidog-name: Success
        '401':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: object
                    properties:
                      error_code:
                        type: string
                      message:
                        type: string
                      extra:
                        type: object
                        properties:
                          api_key:
                            type: string
                        x-apidog-orders:
                          - api_key
                    required:
                      - error_code
                      - message
                    x-apidog-orders:
                      - error_code
                      - message
                      - extra
                required:
                  - detail
                x-apidog-orders:
                  - detail
              example:
                detail:
                  error_code: INVALID_API_KEY
                  message: Invalid or expired API key.
                  extra:
                    api_key: sk_33...
          headers: {}
          x-apidog-name: INVALID_API_KEY
        '404':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: object
                    properties:
                      error_code:
                        type: string
                      message:
                        type: string
                      extra:
                        type: object
                        properties:
                          voice_id:
                            type: string
                        x-apidog-orders:
                          - voice_id
                    required:
                      - error_code
                      - message
                    x-apidog-orders:
                      - error_code
                      - message
                      - extra
                required:
                  - detail
                x-apidog-orders:
                  - detail
              example:
                detail:
                  error_code: VOICE_NOT_FOUND
                  message: Requested voice with ID 17c7… not found.
                  extra:
                    voice_id: 17c7…
          headers: {}
          x-apidog-name: VOICE_NOT_FOUND
        '429':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: object
                    properties:
                      error_code:
                        type: string
                      message:
                        type: string
                      extra:
                        type: object
                        properties:
                          limit:
                            type: integer
                          retry_after_ms:
                            type: integer
                        x-apidog-orders:
                          - limit
                          - retry_after_ms
                    required:
                      - error_code
                      - message
                    x-apidog-orders:
                      - error_code
                      - message
                      - extra
                required:
                  - detail
                x-apidog-orders:
                  - detail
              example:
                detail:
                  error_code: RATE_LIMIT_EXCEEDED
                  message: Rate limit exceeded. Please try again later.
                  extra:
                    limit: 120
                    retry_after_ms: 8500
          headers: {}
          x-apidog-name: RATE_LIMIT_EXCEEDED
        '500':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  method:
                    type: string
                  url:
                    type: string
                  detail:
                    type: string
                required:
                  - message
                  - method
                  - url
                  - detail
                x-apidog-orders:
                  - message
                  - method
                  - url
                  - detail
              example:
                message: Oops! Internal server error occurred.
                method: POST
                url: /v1/tts/stream
                detail: 'Error: Traceback #42'
          headers: {}
          x-apidog-name: Server Error
        x-404:VERSION_NOT_FOUND:
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: object
                    properties:
                      error_code:
                        type: string
                      message:
                        type: string
                    required:
                      - error_code
                      - message
                    x-apidog-orders:
                      - error_code
                      - message
                required:
                  - detail
                x-apidog-orders:
                  - detail
              example:
                detail:
                  error_code: VERSION_NOT_FOUND
                  message: API version v0.9 not found.
          headers: {}
          x-apidog-name: VERSION_NOT_FOUND
      security: []
      x-apidog-folder: API Reference/Voice Management
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/909580/apis/api-31364945-run
components:
  schemas: {}
  securitySchemes: {}
servers: []
security: []

```