# List voices

> Lists the voices an AI receptionist can speak with, the same catalog the Allo app offers. Each id is what voice id takes, and a voice speaks the language it…

`GET /v2/api/voices`

<Note>
**Required scope:** `AGENTS_READ`
</Note>

## Behavior

Lists the voices an AI receptionist can speak with, the same catalog the Allo app offers. Each `id` is what `voice_id` takes on [Update configuration](/docs/agent/update-agent).

A voice speaks the language it is listed under, so pick one that matches the receptionist's `language`. `demo_url` is an audio sample you can play before choosing.

The list is not paginated: it is a fixed catalog.

## Errors

- `403 API_KEY_INSUFFICIENT_SCOPE`: the key does not hold `AGENTS_READ`.
