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

# Get Voice

> Get details on a single voice.

## Overview

Returns the full record for a single voice. Same field shape as [List Voices](/api-v1/get/voices).

The `id` path parameter accepts either the voice's UUID or its `name` (for curated default voices like `maya`, `derek`, `willow`).

***

## Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

***

## Path Parameters

<ParamField path="id" type="string" required>
  Voice UUID or curated voice name. For example:

  * `GET /v1/voices/d4610ec1-933d-44c9-a05f-53df2437808d`
  * `GET /v1/voices/maya`
</ParamField>

***

## Response

<ResponseField name="voice" type="object">
  The voice record. See [List Voices](/api-v1/get/voices#response) for the full field list.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "voice": {
      "id": "d4610ec1-933d-44c9-a05f-53df2437808d",
      "name": "maya",
      "description": "Young American Female",
      "public": true,
      "tags": ["english", "soft", "Bland Curated"],
      "user_id": null,
      "voice_id": "5134ee24-7d14-49a4-8aff-2215d295b6cc",
      "service": "BTTS_V2",
      "finetuned": false,
      "is_creator_voice": false,
      "ratings": 1234,
      "total_ratings": 1234,
      "average_rating": 4.6,
      "my_rating": null,
      "creator_display_name": null
    }
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)