Remove Devices from the Exclusion List

`DELETE /consents`

Removes devices from the exclusion list so that they can be located with a POST /locations or a POST /locationreports request. Up to 2,000 devices can be removed per request.

The request header must set the content-type to JSON, 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.

Parameter Name	Data Type	Description
Authorization (required)	string	HTTP Authorization bearer token: `Authorization: Bearer {token}`
VZ-M2M-Token (required)	string	A valid session token: `VZ-M2M-Token: {M2Mtoken}`
Content-Type (required)	string	Must be application/json `Content-Type: application/json`

HTTP Request

DELETE https://thingspace.verizon.com/api/loc/v1/consents

Request Parameters

Parameter Name	Data Type	Description
accountName (required)	string	The numeric name of a billing account. Must include any leading zeros.
deviceList (required)	array	A list of one hardware identifier for each device that you want to remove from the exclusion list. Valid values include: IMEI. Each identifier will have a `kind` and `id`.
kind	string	The type of identifier. This could be: International Mobile Equipment ID (IMEI).
id	string	The identifier value.

Request Body

The request body gives the accountName and a list of devices to be removed from the exclusion list.

"accountName": "0000123456-00001""deviceIds": [                {                    "kind": "imei",                    "id": "15-digit IMEI"                },                {                    "kind": "imei",                    "id": "15-digit IMEI"                }            ]

Success Responses

Status 200 A response to a successful request contains a single Boolean value:

{  "success": true}

Success Parameters

Parameter Name	Data Type	Description
success	boolean	This response indicates if the request has been successful (`true`) or has failed (`false`).

Failure Responses

All error messages are returned in this format:

{  "errorCode": "The 3-digit HTML error code",  "errorMessage": "string"}

Error codes and messages are listed on the Error Codes page, along with explanations and suggestions for corrective actions.

# Remove Devices from the Exclusion List ### `DELETE /consents` Removes devices from the exclusion list so that they can be located with a POST /locations or a POST /locationreports request. Up to 2,000 devices can be removed per request. ## Header Parameters The request header must set the content-type to JSON, 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: `Authorization: Bearer {token}` | | **VZ-M2M-Token** *(required)* | string | A valid session token: `VZ-M2M-Token: {M2Mtoken}` | | **Content-Type** *(required)* | string | Must be application/json `Content-Type: application/json` | ## HTTP Request [DELETE https://thingspace.verizon.com/api/loc/v1/consents](/docs/premium-apis/device-location/api-endpoints/exclusions/listexcludeddevices) ## Request Parameters |Parameter Name|Data Type|Description| |-----|-----|-----| | **accountName** *(required)* | string | The numeric name of a billing account. Must include any leading zeros. | | **deviceList** *(required)* | array | A list of one hardware identifier for each device that you want to remove from the exclusion list. Valid values include: **IMEI**. Each identifier will have a `kind` and `id`.| | **kind** | string | The type of identifier. This could be: International Mobile Equipment ID (IMEI). | | **id** | string | The identifier value. | ## Request Body The request body gives the `accountName` and a list of devices to be removed from the exclusion list. ```json "accountName": "0000123456-00001" "deviceIds": [ { "kind": "imei", "id": "15-digit IMEI" }, { "kind": "imei", "id": "15-digit IMEI" } ] ``` ## Success Responses **Status 200** A response to a successful request contains a single Boolean value: ```json { "success": true } ``` ## Success Parameters |Parameter Name|Data Type|Description| |-----|-----|-----| | **success** | boolean | This response indicates if the request has been successful (`true`) or has failed (`false`). | ## 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.

Verizon 5G Edge API Portal

Remove Devices from the Exclusion List