---
title: "List Resource Addresses from a Client"
method: GET
path: "/api/fabric/addresses"
tags: ["Addresses"]
---

# List Resource Addresses from a Client

`GET /api/fabric/addresses`

Returns the resource addresses visible to the authenticated [Subscriber](/docs/platform/subscribers). A subscriber client uses this collection to discover the callable handles it can reach. Authenticate with a Subscriber Access Token (SAT) created by [Create Subscriber token](/docs/apis/rest/subscribers/tokens/create-subscriber-token); project administration code should use the project-scoped [List Resource Addresses](/docs/apis/rest/addresses/list-resource-addresses) operation instead.

Resource addresses are callable handles, not standalone SIP Address configurations or physical [E911 Addresses](/docs/apis/rest/e-911-addresses/list-addresses).
#### Permissions

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

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

## Response `200`

The request has succeeded.

- FabricAddressesResponse
  - `data` FabricAddress[], required — An array of objects containing a list of Resource Addresses
    - `id` string, uuid, required — Universal Unique Identifier.
    - `name` string, required — Name of the Fabric Address.
    - `display_name` string, required — Display name of the Fabric Address.
    - `cover_url` string, required — Cover url of the Fabric Address.
    - `preview_url` string, required — Preview url of the Fabric Address.
    - `locked` boolean, required — Locks the Fabric Address. This is used to prevent the Fabric Address from accepting calls.
    - `channels` union, required
      - AudioChannel
        - `audio` string, required — Audio Channel of Fabric Address
      - MessagingChannel
        - `messaging` string, required — Messaging Channel of Fabric Address
      - VideoChannel
        - `video` string, required — Video Channel of Fabric Address
    - `created_at` string, date-time, required — Fabric Address Creation Date.
    - `type` 'app' | 'room' | 'call' | 'subscriber', required — DisplayTypes
  - `links` FabricAddressPaginationResponse, required
    - `self` string, uri, required — Link of the current page
    - `first` string, uri, required — Link to the first page
    - `next` string, uri — Link to the next page
    - `prev` string, uri — Link to the previous page

## Other responses

- `401` — Access is unauthorized.
- `404` — The server cannot find the requested resource.
- `500` — An internal server error occurred.

---

[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-service-production.skmtc.workers.dev/v1/apis/signalwire/signalwire-rest-api/revisions/792d5b8e2970/schema)