> 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. # List SIP credential Addresses GET https://%7BYour_Space_Name%7D.signalwire.com/api/fabric/resources/sip_endpoints/{id}/addresses Returns the project-scoped resource addresses assigned to one SIP Credential. Use these callable handles to see how the registered SIP device can be reached; use [Get SIP credential](/docs/apis/rest/sip-credentials/get-sip-credential) for registration and outbound call-handler settings, or the Subscriber SIP Credential endpoints for a Subscriber-owned device. #### 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/sip-credentials/list-sip-credential-addresses ## Authentication - `Authorization` header (basic auth, required) — SignalWire Basic Authentication using Project ID and API Token. The client sends HTTP requests with the Authorization header containing the word Basic followed by a space and a base64-encoded string of project_id:token. The project ID will be used as the username and the API token as the password. Example: ``` Authorization: Basic base64(project_id:token) ``` ## Request ### Path parameters - `id` (string, required) — The unique identifier of the SIP Endpoint. ## Response ### 200 The request has succeeded. - `data` (list of FabricAddressCall, required) — An array of objects that contain a list of SIP Endpoint Addresses - `links` (SipEndpointAddressPaginationResponse, required) — Object containing pagination links ## 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 ### FabricAddressCall - `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) — The display type of a fabric address pointing to call. - Allowed values: `call` ### SipEndpointAddressPaginationResponse - `self` (string, required) — Link of the current page - `first` (string, required) — Link to the first page - `next` (string, optional) — Link to the next page - `prev` (string, optional) — Link to the previous page ### 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 { "data": [ { "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": "call" } ], "links": { "self": "https://example.signalwire.com/api/fabric/resources/sip_endpoints/7ecfd15a-fb9a-45a4-9b89-c0740a44c593/addresses?page_number=0&page_size=50&type=sip_endpoint", "first": "https://example.signalwire.com/api/fabric/resources/sip_endpoints/7ecfd15a-fb9a-45a4-9b89-c0740a44c593/addresses?page_size=50&type=sip_endpoint", "next": "https://example.signalwire.com/api/fabric/resources/sip_endpoints/7ecfd15a-fb9a-45a4-9b89-c0740a44c593/addresses?page_number=1&page_size=50&page_token=PAbff61159-faab-48b3-959a-3021a8f5beca&type=sip_endpoint", "prev": "https://example.signalwire.com/api/fabric/resources/sip_endpoints/7ecfd15a-fb9a-45a4-9b89-c0740a44c593/addresses?page_number=0&page_size=50&page_token=PAbff61159-faab-48b3-959a-3021a8f5beca&type=sip_endpoint" } } ``` **SDK Code** ```python import requests url = "https://{your_space_name}.signalwire.com/api/fabric/resources/sip_endpoints/id/addresses" response = requests.get(url, auth=("", "")) print(response.json()) ``` ```javascript const url = 'https://{your_space_name}.signalwire.com/api/fabric/resources/sip_endpoints/id/addresses'; const credentials = btoa(":"); const options = {method: 'GET', headers: {Authorization: `Basic ${credentials}`}}; 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/resources/sip_endpoints/id/addresses" req, _ := http.NewRequest("GET", url, nil) req.SetBasicAuth("", "") 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/resources/sip_endpoints/id/addresses") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request.basic_auth("", "") 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/resources/sip_endpoints/id/addresses") .basicAuth("", "") .asString(); ``` ```php request('GET', 'https://{your_space_name}.signalwire.com/api/fabric/resources/sip_endpoints/id/addresses', [ 'headers' => [ ], 'auth' => ['', ''], ]); echo $response->getBody(); ``` ```csharp using RestSharp; using RestSharp.Authenticators; var client = new RestClient("https://{your_space_name}.signalwire.com/api/fabric/resources/sip_endpoints/id/addresses"); client.Authenticator = new HttpBasicAuthenticator("", ""); var request = new RestRequest(Method.GET); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let credentials = Data(":".utf8).base64EncodedString() let headers = ["Authorization": "Basic \(credentials)"] let request = NSMutableURLRequest(url: NSURL(string: "https://{your_space_name}.signalwire.com/api/fabric/resources/sip_endpoints/id/addresses")! 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() ```