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.
| 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.