Device Management

Deactivates service for one or more devices.

POST
/m2m/v1/devices/actions/deactivate

Deactivating service for a device may result in an early termination fee (ETF) being charged to the account, depending on the terms of the contract with Verizon. If your contract allows ETF waivers and if you want to use one for a particular deactivation, set the etfWaiver value to True.

Authorization

thingspace_oauth VZ-M2M-Token
AuthorizationBearer <token>

This is the ThingSpace token, from Credentials and Tokens is used

In: header

VZ-M2M-Token<token>

M2M Session Token (How to generate an M2M session token?)

In: header

Request Body

application/json

Request to deactivate service for one or more devices.

Request to deactivate service for one or more devices.

accountName*string

The name of a billing account.

devices*array<>

The devices for which you want to deactivate service, specified by device identifier.

reasonCode*string

Code identifying the reason for the deactivation. Currently the only valid reason code is “FF”, which corresponds to General Admin/Maintenance.

customFields?array<>

Custom field names and values, if you want to only include devices that have matching values.

etfWaiver?boolean

Fees may be assessed for deactivating Verizon Wireless devices, depending on the account contract. The etfWaiver parameter waives the Early Termination Fee (ETF), if applicable.

groupName?string

The name of a device group, if you want to deactivate all devices in that group.

servicePlan?string

The name of a service plan, if you want to only include devices that have that service plan.

deleteAfterDeactivation?boolean

Response Body

application/json

application/json

curl -X POST "https://example.com/m2m/v1/devices/actions/deactivate" \  -H "Content-Type: application/json" \  -d '{    "devices": [      {        "deviceIds": [          {            "id": "20-digit ICCID",            "kind": "iccid"          }        ]      }    ],    "reasonCode": "FF",    "accountName": "0000123456-00001",    "etfWaiver": true,    "deleteAfterDeactivation": true  }'
{  "requestId": "595f5c44-c31c-4552-8670-020a1545a84d"}