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

# Get Voice

> Retrieve details of a specific voice by its ID

## Overview

This endpoint retrieves details for a specific voice by its `id`. Results can come from your space (custom voices) or from the public catalog filtered by your plan.

## Authentication

<Info>
  This endpoint requires API key authentication. Include your API key in the `Authorization` header.
</Info>

## Path Parameters

<ParamField path="id" type="string" required>
  The identifier of the voice to retrieve.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Unique identifier of the voice.
</ResponseField>

<ResponseField name="name" type="string">
  Display name of the voice.
</ResponseField>

<ResponseField name="language" type="string">
  Language code of the voice (e.g., `fr`, `en`).
</ResponseField>

<ResponseField name="gender" type="string">
  Gender of the voice: `male` or `female`.
</ResponseField>

<ResponseField name="tags" type="array">
  Array of tags associated with the voice (e.g., `[\"friendly\", \"warm\"]`).
</ResponseField>

<ResponseField name="source" type="string">
  Source of the voice: `space` (custom voice) or `config` (public catalog).
</ResponseField>

## Example

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://app.hoox.video/api/public/v1/voice/voice_fr_female_01" \
    -H "Authorization: Bearer your_api_key"
  ```

  ```python Python theme={null}
  import requests

  url = "https://app.hoox.video/api/public/v1/voice/voice_fr_female_01"
  headers = {"Authorization": "Bearer your_api_key"}
  response = requests.get(url, headers=headers)
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://app.hoox.video/api/public/v1/voice/voice_fr_female_01', {
    headers: {
      'Authorization': 'Bearer your_api_key'
    }
  });
  const data = await response.json();
  console.log(data);
  ```
</RequestExample>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "id": "voice_fr_female_01",
    "name": "Charlotte",
    "language": "fr",
    "gender": "female",
    "tags": ["friendly", "warm"],
    "source": "config"
  }
  ```

  ```json Error 404 - Not Found theme={null}
  {
    "error": "Voice not found",
    "details": [
      {
        "code": "NOT_FOUND",
        "message": "Voice with id \"voice_fr_female_01\" not found"
      }
    ]
  }
  ```
</ResponseExample>