# List agent voices

> The voices an agent can speak with, for voice.ttsVoiceId. Filter by language to get the ones that speak it; a voice can still be used with language: auto, where the agent follows the caller and keeps the chosen voice.

`GET https://api.zavu.dev/v1/agents/voices`

The voices an agent can speak with, for `voice.ttsVoiceId`. Filter by `language` to get the ones that speak it; a voice can still be used with `language: auto`, where the agent follows the caller and keeps the chosen voice.

## Parameters

- `language` (query, string): BCP-47 tag (`en`, `es`, `pt-BR`). Omit, or pass `auto`, for every voice.

## Responses

### 200

Available voices.

- `items` (object[], required)
  - `id` (string, required): Value for `voice.ttsVoiceId`.
  - `name` (string, required)
  - `language` (string, required)
- `languages` (string[], required): Languages an agent can be pinned to. `auto` follows the caller.
- `total` (integer): Voices in the catalog, before filtering.

### 401

Unauthorized.

- `code` (string, required)
- `message` (string, required)
- `details` (object)

## Example

```bash
curl -X GET "https://api.zavu.dev/v1/agents/voices?language=es" \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY"
```

```typescript
import Zavudev from "@zavudev/sdk";

const zavu = new Zavudev({ apiKey: process.env.ZAVUDEV_API_KEY });

const result = await zavu.agents.listVoices({
  language: "es",
});

console.log(result);
```