> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev.setoo.work/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List voice numbers

> List the phone numbers registered to your tenant

Returns every voice number registered to your tenant, including which agent each
one is assigned to. Use the `id` from this list as `voiceNumberId` when
[placing a call](/docs/api-reference/calls/make-phone-call) or
[creating a campaign](/docs/api-reference/campaigns/create-campaign).

<CodeGroup>
  ```bash curl theme={null}
  curl https://api.agentic-os.com/api/v1/voice-numbers \
    -H "Authorization: Bearer $AGENTIC_OS_API_KEY"
  ```

  ```python Python theme={null}
  requests.get(
      "https://api.agentic-os.com/api/v1/voice-numbers",
      headers={"Authorization": f"Bearer {API_KEY}"},
  )
  ```

  ```javascript Node theme={null}
  await fetch("https://api.agentic-os.com/api/v1/voice-numbers", {
    headers: { Authorization: `Bearer ${API_KEY}` },
  });
  ```
</CodeGroup>

### Response

```json theme={null}
[
  {
    "id": "660e8400-e29b-41d4-a716-446655440000",
    "number": "+14155551234",
    "provider": "TWILIO",
    "agentId": "550e8400-e29b-41d4-a716-446655440000",
    "isActive": true
  }
]
```