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

# List phone numbers

> GET /v1/phone-numbers

Returns every phone number belonging to your account.

## Request

```bash theme={null}
# All numbers
curl https://api.nixflex.com/v1/phone-numbers \
  -H "Authorization: Bearer KEY_ID:KEY_SECRET"

# Filter to one agent
curl "https://api.nixflex.com/v1/phone-numbers?agent_id=agent_125207e452f8714a" \
  -H "Authorization: Bearer KEY_ID:KEY_SECRET"
```

## Query parameters

| Parameter  | Type   | Notes                                |
| ---------- | ------ | ------------------------------------ |
| `agent_id` | string | Filter numbers attached to one agent |
| `limit`    | int    | Default 25, max 100                  |
| `offset`   | int    | Pagination offset                    |

## Response

`200 OK`:

```json theme={null}
{
  "phone_numbers": [
    {
      "phone_number": "+447446466847",
      "agent_id": "agent_125207e452f8714a",
      "twilio_number_sid": "PN451e0ddf654327e36baab58dfbcd30d6",
      "inbound_enabled": true,
      "outbound_enabled": true,
      "created_at": "2026-05-03T01:59:31.548911+00:00"
    }
  ],
  "count": 1
}
```

Sorted by `created_at` descending. Returns an empty array (not 404) if no numbers exist.