> For the complete documentation index, see [llms.txt](https://anunzi-ai.gitbook.io/anunzi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://anunzi-ai.gitbook.io/anunzi-docs/api-widgets/trabajar-con-la-api-de-llamadas/get-voices.md).

# Voces

**POST**\
`https://api.anunzi.net/v2/voice_agent_voices`

Retrieve a list of all voices assigned to a workspace in your Anunzi environment.

***

#### **Body Parameters**

| Parameter   | Type   | Required | Description                                                                                             |
| ----------- | ------ | -------- | ------------------------------------------------------------------------------------------------------- |
| `workspace` | string | Yes      | The Workspace ID from which to retrieve available voices. This can be obtained from your Anunzi Portal. |

***

#### **Example Request (cURL)**

```bash
curl --request POST \
     --url https://api.anunzi.net/v2/voice_agent_voices \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'Authorization: Bearer API_KEY' \
     --data '
{
  "workspace": "1696372226173x164740052408336400"
}
'
```

***

#### **Example Response (200 OK)**

```json
{
  "status": "ok",
  "response": {
    "voices": [
      {
        "voice_id": "wefw5e68456wef",
        "name": "test",
        "preview": "",
        "workspace": "1710107690998x536152705164378100"
      }
    ]
  }
}
```

***

#### **Response Fields**

| Field       | Type   | Description                                      |
| ----------- | ------ | ------------------------------------------------ |
| `voice_id`  | string | The unique identifier for the voice.             |
| `name`      | string | The name of the voice.                           |
| `preview`   | string | A URL for a preview of the voice (if available). |
| `workspace` | string | The Workspace ID associated with the voice.      |

***

#### **Status Codes**

| Code | Description                                 |
| ---- | ------------------------------------------- |
| 200  | Voices retrieved successfully.              |
| 400  | Bad Request. Invalid or missing parameters. |