> 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-numbers.md).

# Números

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

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

***

#### **Body Parameters**

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

***

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

```bash
curl --request POST \
     --url https://api.anunzi.net/v2/voice_agent_numbers \
     --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": {
    "phone_numbers": [
      {
        "number": "+14158811313",
        "sid": "PN840358ba5ed985a2eb1f2ab4e83657f2"
      },
      {
        "number": "+14157671804",
        "sid": "PNd8a2e05b8395d5729fc889006a5c3b76"
      },
      {
        "number": "+17085723202",
        "sid": "PN52d012288194a6d42711c71dc822f4e3"
      }
    ]
  }
}
```

***

#### **Response Fields**

| Field    | Type   | Description                                 |
| -------- | ------ | ------------------------------------------- |
| `number` | string | The phone number assigned to the workspace. |
| `sid`    | string | The unique identifier for the phone number. |

***

#### **Status Codes**

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