# Get a List of Registered Callback Listeners ### `GET /callbacks/{accountName}` Returns the name and endpoint URL of the callback listening services registered for a given account. ## HTTP Request GET [https://thingspace.verizon.com/api/loc/v1/callbacks/{accountName}](/docs/standard-apis/connectivity-management/api-endpoints/connectivity-callbacks/list-registered-callbacks/listregisteredcallbacks) ## Resource and Query Parameters The account name must be included in the path. | Parameter Name | Data Type | Description | |:----------------|:-----------|:-------------| | **accountName** *(required)* | string | The name of the account for which a list of registered callback services will be returned. An account name is usually numeric, and must include any leading zeros. | ## Header Parameters The request header must contain a current ThingSpace authorization token and a current VZ-M2M session token. For more details on how to get these tokens, visit [Getting Started](https://thingspace.verizon.com/documentation/api-documentation.html#/http/session-management/guides/getting-started). | Parameter Name | Data Type | Description | |:----------------|:-----------|:-------------| | **Authorization** *(required)* | string | HTTP Authorization bearer token: <br> `Authorization: Bearer {token}`. | | **VZ-M2M-Token** *(required)* | string | A valid session token returned by `POST /api/m2m/v1/session/login`. | | **Content-Type** *(required)* | string | Must be application/json `Content-Type: application/json` | ## Request Body None. ## Success Responses **Status 200** | Parameter Name | Data Type | Description | |:----------------|:-----------|:-------------| | **accountName** | string | The name of the billing account for which callback messages will be sent. | | **serviceName** | string | The name of the callback service, which identifies the type and format of messages that will be sent to the registered URL. The value will be **Location** for the Device Location Service callback. | | **url** | string | The address of the callback listening service where the ThingSpace Platform will send callback messages for the service type. | | **username** | string | The username defined when a URL was registered for the callback service, or an empty string if no username was defined. | | **password** | string | The password defined when a URL was registered for the callback service, or an empty string if no password was defined. | **Note:**The response body will be empty if there are no callback services registered with the account. ### Example Success Response ```json [ { "accountName": "0000123456-00001", "serviceName": "Location", "url": "http://10.120.102.147:50569/CallbackListener/Location.asmx" }, { "accountName": "0000123456-00002", "serviceName": "DeviceLocation", "url": "http://10.120.102.147:50569/CallbackListener/DeviceLocation.asmx" } ] ``` ## Failure Responses All error messages are returned in this format: ```json { "errorCode": "The 3-digit HTML error code", "errorMessage": "string" } ``` Error codes and messages are listed on the [Error Codes page](https://thingspace.verizon.com/documentation/api-documentation.html#/http/device-location/error-codes), along with explanations and suggestions for corrective actions.