Remove Devices From Exclusion List

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.

Contents

See also:
Exclude Devices
Get a list of excluded devices

Uses and Requirements

You can remove up to 2,000 devices per request.

Request Components

HTTP Request

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

Resource Path and Query Parameters

None.

Header Parameters

The request header must contain a current ThingSpace authorization bearer token and a valid VZ-M2M session token, and must set the content-type to JSON.

Parameter Name Data Type Description
Authorization
required
string HTTP 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.

Request Body

The request body gives the account name and list of devices to be removed from the exclusion list.

Parameter Name Data Type Description
accountName
required
string The name of a billing account, which is usually in the format of 10 digits, a hyphen, and then five more digits. Must include any leading zeros.
deviceList
required
array of strings A list of one hardware identifier for each device that you want to remove from the exclusion list. You can use IMEI, MEID, or ESN.

Success Responses

Status 200

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

{
  "success": true
}

Failure Responses

Status 400

All error messages are returned in this format:

{
  "errorCode": "The type of error, such as INVALID_REQUEST.",
  "errorMessage": "Additional error information."
}

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

Try It Out!