> For the complete documentation index, see [llms.txt](https://docs.limephone.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.limephone.io/api-reference/phone-numbers.md).

# Phone numbers

The numbers on your account and their routing settings.

## List phone numbers

`GET /v1/phone-numbers` — scope `phone-numbers:read`

Lists every phone number on your organization, with its settings.

```bash
curl https://dashboard.limephone.io/api/v1/phone-numbers \
  -H "Authorization: Bearer sk_live_..."
```

## Get a phone number

`GET /v1/phone-numbers/{id}` — scope `phone-numbers:read`

Fetches one phone number by id.

## Update a phone number

`PATCH /v1/phone-numbers/{id}` — scope `phone-numbers:write`

| Field              | Type    | Notes                                    |
| ------------------ | ------- | ---------------------------------------- |
| `friendlyName`     | string  | Display label for the number             |
| `callForwarding`   | string  | Number to forward incoming calls to      |
| `voicemailEnabled` | boolean | Whether unanswered calls go to voicemail |

```bash
curl -X PATCH https://dashboard.limephone.io/api/v1/phone-numbers/pn_31xk \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "friendlyName": "Support line", "voicemailEnabled": true }'
```