# ThingSpace Device Location Quick APIs Reference This API reference is organized by functional area, which generally equates to resource type. Hope you are enjoying our latest upgrades, but you can still access the [Legacy Documentation](https://thingspace.verizon.com/documentation/apis/device-location/api-reference.html) for a limited time ## Find device locations | HTTP Request | Description | | ------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | | [`POST /locations`](/docs/premium-apis/device-location/api-endpoints/devices-locations/listdeviceslocationssynchronous) | Find the locations of up to 20 devices (synchronous) | | [`POST /locationreports`](/docs/premium-apis/device-location/api-endpoints/devices-locations/createlocationreport) | Create a report of device locations (asynchronous) | | [`GET /locationreports/{accountName}/report/{txid}/index/{startindex}`](/docs/premium-apis/device-location/api-endpoints/devices-locations/retrievelocationreport) | Retrieve a device location report | | [`GET /locationreports/{accountName}/report/{txid}/status`](/docs/premium-apis/device-location/api-endpoints/devices-locations/getlocationreportstatus) | Get the status of a device location report | | [`DELETE /locationreports/{accountName}/report/{txid}`](/docs/premium-apis/device-location/api-endpoints/devices-locations/cancelqueuedlocationreportgeneration) | Cancel a queued device location report | | [`DELETE /devicelocations/{txid}?accountName={accountName}`](/docs/premium-apis/device-location/api-endpoints/device-location-callbacks/cancelasyncreport) | Cancel an asynchronous device location report. | ## Exclude devices from location services | HTTP Request | Description | | ------------------------------------------------------------------------- | -------------------------------------------------- | | [`POST /devicelocations/action/consents`](/docs/premium-apis/device-location/api-endpoints/exclusions/deviceslocationgiveconsentasync) | Create the consent record for devices | | [`PUT /devicelocations/action/consents`](/docs/premium-apis/device-location/api-endpoints/exclusions/deviceslocationupdateconsent) | Update the consent record for devices | | [`POST /consents`](/docs/premium-apis/device-location/api-endpoints/exclusions/excludedevices) | Exclude or included devices from location services | | [`GET /consents/{accountName}`](/docs/premium-apis/device-location/api-endpoints/exclusions/removedevicesfromexclusionlist) | Get a list of excluded devices | | [`DELETE /consents`](/docs/premium-apis/device-location/api-endpoints/exclusions/listexcludeddevices) | Removes devices from the exclusion list | | [GET /consents/{accountName}/index/{startIndex}](/docs/premium-apis/device-location/api-endpoints/exclusions/listexcludeddevices) | List the devices excluded from location services | | [GET devicelocations/action/consents?{accountName}&{deviceid}&{deviceid}](/docs/premium-apis/device-location/api-endpoints/exclusions/deviceslocationgetconsentasync) | Retrieve consent settings fro the account or a device or a list of devices | ## Manage subscription status and usage | HTTP Request | Description | | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- | | [`GET /subscriptions/{accountName}`](/docs/premium-apis/device-location/api-endpoints/devices-location-subscriptions/getlocationservicesubscriptionstatus) | Get location service subscription status | | [`POST /usage`](/docs/premium-apis/device-location/api-endpoints/devices-location-subscriptions/getlocationserviceusage) | Get Location Service Usage information for a specified period | | [`POST /usage/triggers`](/docs/premium-apis/device-location/api-endpoints/usage-trigger-management/createnewtrigger) | Create a new usage trigger | | [`GET /usage/accounts/{accountName}/triggers`](/docs/premium-apis/device-location/api-endpoints/devices-location-subscriptions/getlocationserviceusage)| Retrieve information about a trigger, or all triggers in an account | | [`POST /usage/triggers/{triggerId}`](/docs/premium-apis/device-location/api-endpoints/usage-trigger-management/updatetrigger) | Change an existing trigger's settings. | | [`DELETE /usage/accounts/{accountName}/triggers/{triggerId}`](/docs/premium-apis/device-location/api-endpoints/usage-trigger-management/deletetrigger) | Delete a specified trigger. | ## Receive callback messages | HTTP Request | Description | | --------------------------------------------------------------------------------------------------- | -------------------------------------- | | [`POST /callbacks/{accountName}`](/docs/standard-apis/connectivity-management/api-endpoints/connectivity-callbacks/register-callback/registercallback) | Register to receive callback messages | | [`GET /callbacks/{accountName}`](/docs/standard-apis/connectivity-management/api-endpoints/connectivity-callbacks/list-registered-callbacks/listregisteredcallbacks) | View registered callback listener URLs | | [`DELETE /callbacks/{accountName}/name/{service}`](/docs/standard-apis/connectivity-management/api-endpoints/connectivity-callbacks/deregister-callback/deregistercallback) | Deregister a callback listener | ## Aggregated billing services | HTTP Request | Description | | --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | [`POST /managedaccounts/actions/add`](/docs/premium-apis/device-location/api-endpoints/billing/addaccount) | Adds a list of account for managed billing to a primary account. | | [`POST /managedaccounts/actions/provision`](/docs/premium-apis/device-location/api-endpoints/billing/managedaccountaction) | Activates a managed billing service relationship between managed account and primary account | | [`GET /managedaccounts/{accountName}/service/{servicename/status/{status}`](/docs/premium-apis/device-location/api-endpoints/billing/listmanagedaccount) | Returns a list of managed accounts for a primary account. | | [`POST /managedaccounts/actions/cancel`](/docs/premium-apis/device-location/api-endpoints/billing/cancelmanagedaccountaction) | Deactivates a managed billing service relationship between managed account and the primary account. |