Skip to navigation

List Resource Addresses from a Client

View as MarkdownOpen in Claude

Returns the resource addresses visible to the authenticated Subscriber. 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; project administration code should use the project-scoped List Resource Addresses operation instead.

Resource addresses are callable handles, not standalone SIP Address configurations or physical E911 Addresses.

This operation was previously served at /api/fabric/addresses. That path still answers SAT-authenticated requests with the same response body, including pagination links that keep the old path, and adds a Deprecation: true header and a Link header naming /api/fabric/subscriber/addresses as the successor. No removal date is set. Use /api/fabric/subscriber/addresses in new code.

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.

Authentication

AuthorizationBearer

SignalWire Bearer Token Authentication for subscriber endpoints. The client sends HTTP requests with the Authorization header containing the word Bearer followed by a space and the subscriber token.

Example:

Authorization: Bearer <subscriber_token>

Response

The request has succeeded.
items_countinteger
The number of addresses in this page of results.
datalist of objects
An array of objects containing a list of Resource Addresses

Errors

500
Internal Server Error