> ## 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 Settings

> Get the current consistency/expressiveness defaults on a voice you own.

## Overview

Returns the current synthesis defaults stored on a voice you own, plus the valid range for each tunable so callers do not have to discover the bounds by trial and error.

Different engines expose different settings:

* **BTTS V1**: `consistency` (0-1 float) and `expressiveness` (0-1 float).
* **BTTS V2**: `consistency` (0-64 integer, lower is more consistent) and `expressiveness` (0-1 float).
* **BTTS V3**: a single boolean `boost_language_consistency`.

To update these settings, use [Update Voice Settings](https://docs.bland.ai/api-v1/post/voices-id-settings.md).

***

## Headers

**authorization** `string` *required*

Your API key for authentication.

***

## Path Parameters

**id** `string` *required*

UUID of the voice.

***

## Response

For V1 and V2 voices:

**consistency** `number`

**expressiveness** `number`

**service** `string`

The engine identifier, e.g. `BTTS_V2`.

**limits** `object`

Valid ranges for the tunables.

**limits fields**

**consistency.min** `number`

**consistency.max** `number`

`1` for V1, `64` for V2.

**expressiveness.min** `number`

**expressiveness.max** `number`

For V3 voices:

**boost\_language\_consistency** `boolean`

**service** `string`

`BTTS_V3`.

```json V2 Response theme={null}
{
  "consistency": 8,
  "expressiveness": 1,
  "service": "BTTS_V2",
  "limits": {
    "consistency": { "min": 0, "max": 64 },
    "expressiveness": { "min": 0, "max": 1 }
  }
}
```

```json V3 Response theme={null}
{
  "boost_language_consistency": true,
  "service": "BTTS_V3"
}
```

```json Not Owned theme={null}
{
  "data": null,
  "errors": [
    { "error": "VOICE_SETTINGS_ERROR", "message": "Voice is a default voice and not owned by the user." }
  ]
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


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