---
title: "List phone number addresses"
method: GET
path: "/api/fabric/phone_number_addresses"
tags: ["Phone Number Addresses"]
---

# List phone number addresses

`GET /api/fabric/phone_number_addresses`

Lists the phone number addresses in your SignalWire project, newest first. Each address represents one channel (`calling` or `messaging`) of a phone number you own, together with the resource that handles it, if any. Addresses whose number has been released are not included. Use it to find the address ID for a number's channel before you link, re-point, or remove its resource.

Only the pagination parameters are supported; there are no filters. A `page_token` that is malformed or no longer resolves returns a `422` with the code `page_token_is_invalid`.

<Warning title="Beta">This API is in beta and may change.</Warning>

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Calling_, _Fax_, _Messaging_, or _Video_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Query parameters

- `page_size` integer
- `page_number` integer
- `page_token` string

## Response `200`

The request has succeeded.

- PhoneNumberAddressListResponse
  - `links` PhoneNumberAddressPaginationResponse, required
    - `self` string, uri, required — Link to the current page of results.
    - `first` string, uri, required — Link to the first page of results.
    - `next` string, uri — Link to the next page of results.
    - `prev` string, uri — Link to the previous page of results.
  - `items_count` integer, required — The number of phone number addresses in this page of results.
  - `data` PhoneNumberAddress[], required — An array of phone number address objects.
    - `id` string, uuid, required — Universal Unique Identifier.
    - `type` 'phone', required — The object type. Always `phone`.
    - `handler_type` 'calling' | 'messaging', required — Sets the handler to handle incoming `calls` or `messages`.
    - `resource_id` string, uuid, required — Universal Unique Identifier.
    - `name` string, required — Name of the phone number address.
    - `phone_number` string, required — The phone number in E.164 format.
    - `phone_number_id` string, uuid, required — Universal Unique Identifier.
    - `created_at` string, date-time, required — Date and time when the phone number address was created.
    - `updated_at` string, date-time, required — Date and time when the phone number address was last updated.

## Other responses

- `401` — Access is unauthorized.
- `422` — The request contains invalid parameters. See errors for details.
- `500` — An internal server error occurred.

## Changes

> 161 revisions in range; 3 could not be searched.

- **2026-09-15** `7506aebc9ef3` — 1 info
  - endpoint added
- **2026-09-15** `f0464a93a362` — 1 breaking
  - api path removed without deprecation
- **2026-09-15** `525afaa1e832` — 1 warning, 1 info
  - added the new `phone` enum value to the `data/items/type` response property for the response status `200`
  - removed the `phone_number_address` enum value from the `data/items/type` response property for the response status `200`
- **2026-09-15** `e35eaf5d474d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/signalwire/apis/signalwire-rest-api/changes/api/fabric/phone_number_addresses/get.md)

---

[API](https://skmtc.dev/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.dev/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signalwire/apis/signalwire-rest-api/revisions/20ee0f568ece?raw)