# Get Voice

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /voices/{id}:
    get:
      summary: Get Voice
      deprecated: false
      description: Get a voice from the voice library by its ID
      tags:
        - API Reference/Voice Management
      parameters:
        - name: id
          in: path
          description: Voice id
          required: true
          example: ''
          schema:
            type: string
        - 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
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                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
                    enum:
                      - PREDEFINED
                      - CUSTOM
                    x-apidog-enum:
                      - value: PREDEFINED
                        name: ''
                        description: stock voice
                      - value: CUSTOM
                        name: ''
                        description: custom cloned voice
                    description: Whether the voice is owned by the current user
                required:
                  - voice_id
                  - name
                  - description
                  - language
                  - gender
                  - accent
                  - style
                  - created_at
                  - updated_at
                  - voice_type
                x-apidog-orders:
                  - voice_id
                  - name
                  - description
                  - language
                  - gender
                  - accent
                  - style
                  - created_at
                  - updated_at
                  - voice_type
              example:
                voice_id: d4g7a640-4412-4e78-bba5-5c636692cc04
                name: Name
                description: Description
                language: en
                gender: Male
                accent: American (US)
                style: Storytelling
                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-16699699-run
components:
  schemas: {}
  securitySchemes: {}
servers: []
security: []

```