> 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 Applications GET https://YOUR_SPACE.signalwire.com/api/laml/2010-04-01/Accounts/{AccountSid}/Applications Lists the account's Applications, which provide reusable voice and messaging routing. These applications are also available as addressable [cXML Applications](/docs/apis/rest/cxml-applications/list-cxml-applications) in the SignalWire REST API. Use this collection for code built around Application SIDs. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_ or _Messaging_ or _Fax_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space). Reference: https://signalwire.com/docs/compatibility-api/rest/applications/list-applications ## 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 - `AccountSid` (string, required) — The Account ID that has the Application. ### Query parameters - `FriendlyName` (string, optional) — Filter by a named unique identifier for the resource. - `Page` (integer, optional, default: 0) — The page number to retrieve. Page numbers are zero-indexed, so the first page is 0. - `PageSize` (integer, optional, default: 50) — The number of results to return per page. The default is 50, and the maximum is 1000. - `PageToken` (string, optional) — A token used to retrieve a specific page of results. ## Response ### 200 The request has succeeded. - `uri` (string, required) — The URI for this resource. - `first_page_uri` (string, required) — The URI for the first page of results. - `next_page_uri` (string, required, nullable) — The URI for the next page of results. Null if there are no more pages. - `previous_page_uri` (string, required, nullable) — The URI for the previous page of results. Null if this is the first page. - `page` (integer, required) — The current page number. Zero-indexed. - `page_size` (integer, required) — The number of results per page. - `applications` (list of Application, required) — List of applications. ## Errors ### 400 Bad Request Error The request was invalid or cannot be processed. Check the error details for more information. - `code` (integer, required) — Error code. - `message` (string, required) — Error message. - `more_info` (string, required) — URL for more information about the error. - `status` (integer, required) — HTTP status code. ### 401 Unauthorized Error Authentication failed. Please verify your credentials and try again. - `code` (integer, required) — Error code. - `message` (string, required) — Error message. - `more_info` (string, required) — URL for more information about the error. - `status` (integer, required) — HTTP status code. ### 422 Unprocessable Entity Error The request could not be processed due to validation errors. Check the error details for more information. - `code` (integer, required) — Error code. - `message` (string, required) — Error message. - `more_info` (string, required) — URL for more information about the error. - `status` (integer, required) — HTTP status code. ## Types ### Application Application model representing a cXML application. - `sid` (string, required) — The unique identifier for the Application. - `account_sid` (string, required) — The unique identifier for the Account that created this Application. - `api_version` (string, required) — The version of the SignalWire API. - `date_created` (string, required) — The date, in RFC 2822 GMT format, this Application was created. - `date_updated` (string, required) — The date, in RFC 2822 GMT format, this Application was updated. - `friendly_name` (string, required) — A named unique identifier for the resource. - `uri` (string, required) — The URI for this Application. - `voice_url` (string, required, nullable) — The URL to request when a phone number receives a call or fax. - `voice_method` (string, required, nullable) — Whether the request to `VoiceUrl` is a `GET` or a `POST`. Default is `POST`. - `voice_fallback_url` (string, required, nullable) — The URL SignalWire will request if errors occur when fetching the `VoiceUrl`. - `voice_fallback_method` (string, required, nullable) — Whether the request to `VoiceFallbackUrl` is a `GET` or a `POST`. Default is `POST`. - `status_callback` (string, required, nullable) — The URL to pass status updates to the Application. - `status_callback_method` (string, required, nullable) — Whether the request to the `StatusCallback` URL is a `GET` or a `POST`. Default is `POST`. - `voice_caller_id_lookup` (boolean, required, nullable) — Whether or not to look up a caller's ID from the database. Always null. - `sms_url` (string, required, nullable) — The URL to request when an SMS is received. - `sms_method` (string, required, nullable) — Whether the request to `SmsUrl` is a `GET` or a `POST`. Default is `POST`. - `sms_fallback_url` (string, required, nullable) — The URL SignalWire will request if errors occur when fetching the `SmsUrl`. - `sms_fallback_method` (string, required, nullable) — Whether the request to `SmsFallbackUrl` is a `GET` or a `POST`. Default is `POST`. - `sms_status_callback` (string, required, nullable) — The URL to receive status updates for messages sent via this Application. - `sms_status_callback_method` (string, required, nullable) — Whether the request to `SmsStatusCallback` is a `GET` or a `POST`. Default is `POST`. - `message_status_callback` (string, required, nullable) — The URL to receive status updates for messages sent via this Application. ## Examples **Response** ```json { "uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Applications?Page=0&PageSize=50", "first_page_uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Applications?Page=0&PageSize=50", "next_page_uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Applications?Page=1&PageSize=50", "previous_page_uri": null, "page": 0, "page_size": 50, "applications": [ { "sid": "b3877c40-da60-4998-90ad-b792e98472af", "account_sid": "b3877c40-da60-4998-90ad-b792e98472af", "api_version": "2010-04-01", "date_created": "Sat, 15 Sept 2018 10:00:00 +0000", "date_updated": "Sat, 16 Sept 2018 10:00:00 +0000", "friendly_name": "My Friendly Name", "uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Applications/b3877c40-da60-4998-90ad-b792e98472af.json", "voice_url": "http://example.com", "voice_method": "POST", "voice_fallback_url": "http://example.com", "voice_fallback_method": "POST", "status_callback": "http://example.com", "status_callback_method": "POST", "voice_caller_id_lookup": null, "sms_url": "http://example.com", "sms_method": "POST", "sms_fallback_url": "http://www.example.com/sms-fallback", "sms_fallback_method": "POST", "sms_status_callback": "http://www.example.com/sms-status-callback", "sms_status_callback_method": "POST", "message_status_callback": "http://www.example.com/sms-status-callback" } ] } ``` **SDK Code** ```python import requests url = "https://your_space.signalwire.com/api/laml/2010-04-01/Accounts/AccountSid/Applications" response = requests.get(url, auth=("", "")) print(response.json()) ``` ```javascript const url = 'https://your_space.signalwire.com/api/laml/2010-04-01/Accounts/AccountSid/Applications'; 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.signalwire.com/api/laml/2010-04-01/Accounts/AccountSid/Applications" 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.signalwire.com/api/laml/2010-04-01/Accounts/AccountSid/Applications") 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.signalwire.com/api/laml/2010-04-01/Accounts/AccountSid/Applications") .basicAuth("", "") .asString(); ``` ```php request('GET', 'https://your_space.signalwire.com/api/laml/2010-04-01/Accounts/AccountSid/Applications', [ 'headers' => [ ], 'auth' => ['', ''], ]); echo $response->getBody(); ``` ```csharp using RestSharp; using RestSharp.Authenticators; var client = new RestClient("https://your_space.signalwire.com/api/laml/2010-04-01/Accounts/AccountSid/Applications"); 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.signalwire.com/api/laml/2010-04-01/Accounts/AccountSid/Applications")! 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() ```