> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes. # Get Resource Address from a Client GET https://%7BYour_Space_Name%7D.signalwire.com/api/fabric/addresses/{id} 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). Reference: https://signalwire.com/docs/apis/rest/addresses/get-resource-address-client ## Authentication - `Authorization` header (bearer token, required) — 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 ``` ## Request ### Path parameters - `id` (string, required) — Unique ID of a FabricAddress. ## Response ### 200 The request has succeeded. - `id` (string, required) — Unique ID of the Fabric Address. - `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` (AddressChannel, required) — Channels of the Fabric Address. - `created_at` (datetime, required) — Fabric Address Creation Date. - `type` (enum, required) — DisplayTypes - Allowed values: `app`, `room`, `call`, `subscriber` ## Errors ### 401 Unauthorized Error Access is unauthorized. - `error` (enum, required) - Allowed values: `Unauthorized` ### 404 Not Found Error The server cannot find the requested resource. - `error` (enum, required) - Allowed values: `Not Found` ### 500 Internal Server Error An internal server error occurred. - `error` (enum, required) - Allowed values: `Internal Server Error` ## Types ### AddressChannel ### 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 ## Examples **Response** ```json { "id": "691af061-cd86-4893-a605-173f47afc4c2", "name": "justice-league", "display_name": "Justice League", "cover_url": "https://coverurl.com", "preview_url": "https://previewurl.com", "locked": true, "channels": { "audio": "/external/resource_name?channel=audio" }, "created_at": "2024-05-06T12:20:00Z", "type": "app" } ``` **SDK Code** ```python import requests url = "https://{your_space_name}.signalwire.com/api/fabric/addresses/id" headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript const url = 'https://{your_space_name}.signalwire.com/api/fabric/addresses/id'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://{your_space_name}.signalwire.com/api/fabric/addresses/id" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://{your_space_name}.signalwire.com/api/fabric/addresses/id") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://{your_space_name}.signalwire.com/api/fabric/addresses/id") .header("Authorization", "Bearer ") .asString(); ``` ```php request('GET', 'https://{your_space_name}.signalwire.com/api/fabric/addresses/id', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://{your_space_name}.signalwire.com/api/fabric/addresses/id"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://{your_space_name}.signalwire.com/api/fabric/addresses/id")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```