Get Resource Address from a Client

GET

https://{your_space_name}.signalwire.com/api/fabric/addresses/:id

Retrieves one resource address visible to the authenticated Subscriber by address ID. Use it when a subscriber client already holds a callable address identifier; use List Resource Addresses from a Client to discover visible addresses. Authenticate with a Subscriber Access Token (SAT), not a project API token.

Resource addresses are callable handles, not standalone SIP Address configurations or physical E911 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.

Retrieves one resource address visible to the authenticated [Subscriber](/docs/platform/subscribers) by address ID. Use it when a subscriber client already holds a callable address identifier; use [List Resource Addresses from a Client](/docs/apis/rest/addresses/list-resource-addresses-client) to discover visible addresses. Authenticate with a Subscriber Access Token (SAT), not a project API token. Resource addresses are callable handles, not standalone SIP Address configurations or physical [E911 Addresses](/docs/apis/rest/e-911-addresses/get-address). #### 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).

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>

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> ```

Path parameters

idstringRequiredformat: "uuid"

Unique ID of a FabricAddress.

Response

The request has succeeded.

idstringformat: "uuid"

Unique ID of the Fabric Address.

namestring

Name of the Fabric Address.

display_namestring

Display name of the Fabric Address.

cover_urlstring

Cover url of the Fabric Address.

preview_urlstring

Preview url of the Fabric Address.

lockedboolean

Locks the Fabric Address. This is used to prevent the Fabric Address from accepting calls.

channelsobject

Channels of the Fabric Address.

created_atdatetime

Fabric Address Creation Date.

typeenum

DisplayTypes

Errors

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error