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

# Get a voice

Look up a public voice even if it is not a favorite. The result includes `voiceId` for synthesis and this workspace’s `isFavorite` flag. To look up a private voice, use a key in its owning workspace. If you lost the ID, [list your workspace voices](https://docs.gengen.farm/api-reference/elevenlabs/voices.md).

| Private voice status | Next step |
| - | - |
| `active` | Use the returned `voiceId` for speech or dialogue. |
| `verificationRequired` | Send the `voiceId` to [GENGEN support](https://gengen.farm/support), then repeat this lookup to check for activation. |
| `creating`, `reconciling` | [Poll the returned `statusUrl`](https://docs.gengen.farm/api-reference/elevenlabs/get-voice-operation). If reconciliation persists, [contact support](https://gengen.farm/support). |
| `failed` | Read `message` if present for the reason. |
| `deleting` | Retry DELETE with the same `voiceId` to finish removal. |
| `deleted` | The voice has been removed. |


## OpenAPI

````yaml openapi/audio.yaml GET /audio/voices/{voiceId}
openapi: 3.1.0
info:
  title: GENGEN Audio API
  version: 1.0.0
  description: >-
    Speech, dialogue, voice design, workspace voices, realtime sessions and
    completion webhooks.
servers:
  - url: https://gengen.farm/api/gengen/v1
security:
  - bearerAuth: []
paths:
  /audio/voices/{voiceId}:
    get:
      tags:
        - Voices
      summary: Get a voice
      operationId: audio-get-voice
      parameters:
        - name: voiceId
          in: path
          required: true
          schema:
            type: string
          description: >-
            Official public ID, supported public alias or private ID from this
            workspace.
      responses:
        '200':
          description: >-
            Public voice and workspace favorite status, or private voice and
            current lifecycle status.
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/Voice'
                  - $ref: '#/components/schemas/PrivateVoice'
        default:
          description: Voice is unavailable or does not belong to this workspace.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Voice:
      type: object
      required:
        - id
        - voiceId
        - kind
        - isFavorite
        - name
        - status
        - models
      properties:
        voiceId:
          type: string
          description: Voice ID to use for synthesis across all scopes.
        kind:
          type: string
          enum:
            - public
        isFavorite:
          type: boolean
          description: Whether this workspace has saved this public voice.
        id:
          type: string
          description: >-
            Normally the same as voiceId. Older saved public voices may have a
            curated alias here.
        providerVoiceId:
          type: string
          description: >-
            Underlying voice ID for an older saved public voice. For synthesis
            use voiceId.
        description:
          type: string
        language:
          type: string
        accent:
          type: string
        gender:
          type: string
        age:
          type: string
        name:
          type: string
        status:
          type: string
        models:
          type: array
          items:
            type: string
          description: Speech models enabled for this voice in the GENGEN catalog.
        previewUrl:
          type:
            - string
            - 'null'
    PrivateVoice:
      type: object
      required:
        - name
        - kind
        - status
        - models
      properties:
        operationId:
          type: string
          format: uuid
          description: Creation tracking ID returned while pending.
        statusUrl:
          type: string
          description: >-
            Relative URL for polling a pending creation with the workspace API
            key.
        id:
          type: string
          description: Same as voiceId once the voice has an ID.
        voiceId:
          type: string
          description: Same value as id. Use for speech and dialogue when active.
        name:
          type: string
        kind:
          type: string
          enum:
            - clone
            - design
        status:
          type: string
          enum:
            - creating
            - reconciling
            - active
            - verificationRequired
            - failed
            - deleting
            - deleted
        message:
          type: string
          description: >-
            Optional provider explanation on a failed or reconciling private
            voice. Use status to determine the outcome.
        models:
          type: array
          items:
            type: string
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
          required:
            - code
            - message
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.