Change Device Identifier

PUT /devices/{serviceType}/actions/deviceId

Changes the identifier of a 3G or 4G device to match hardware changes made for a line of service. Use this request to transfer the line of service and the MDN to new hardware, or to change the MDN.

Uses and Requirements

• After changing a device identifier, the old identifier cannot be used to get any device history, such as with GetAggrregateDeviceUsage or GetDeviceProvisioningHistory.
• You can use a device identifier that did not change to get any type of device history that spans the change date. For example, you can use the MSISDN if you only changed the ICCID.

NOTE: Both of these conditions must be true for this call to succeed:

• The existing device must be in the Active state with an MDN/MSISDN assigned.
• The new hardware (MEID or ICCID) cannot already be in the ThingSpace Platform database. To reuse a deactivated device, you must first delete the device with a POST /devices/actions/delete request.

The ThingSpace Platform sends a CarrierService callback message when the device identifier has been changed, or if there was a problem and the change could not be completed.

Request Components

HTTP Request

PUT https://thingspace.verizon.com/api/m2m/v1/devices/{serviceType}/actions/deviceId
    

Resource Path and Query Parameters

You must specify in the resource path whether you are changing 3G or 4G devices.

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.

Request Body

Specify the device to change using the old ID or one that isn’t changing.

Set the new ID and other values.

Example Request Body

Put a new SIM in a 4G device

{
      "deviceIds": [
         {
         "id": "42590078891480000008",
         "kind": "iccid"
         }
      ],
      "deviceIdsTo": [
         {
            "id": "89148000000842590078",
            "kind": "iccid"
         }
       ],
      "change4gOption": "ChangeICCID",
      "zipCode": "98802",
      "servicePlan": "4G 2GB"
    }
    

Request a new phone number

{
      "deviceIds": [
         {
         "id": "42590078891480000008",
         "kind": "iccid"
         }
      ],
      "change4gOption": "ChangeMSISDN",
      "assignNonGeoMdn": false,
      "npaNxx": "509393",
      "servicePlan": "M2M2GB"
    }
    

Success Responses

Status 200

Example Success Response

{
      "requestId": "595f5c44-c31c-4552-8670-020a1545a84d"
    }
    

Example Success Callback Response

{  
      "username":"",
      "password":"",
      "requestId":"a28892ea-6503-4aa7-bfa2-4cd45d42f61b",
      "deviceIds":[  
        {  
          "id":"22211315718",
          "kind":"ESN"
        }
      ],
      "deviceResponse":{  
        "changeIdentifierResponse":{  
          "deviceIds":[  
            {  
              "id":"A1000001999990",
              "kind":"iccid"
            }
          ],
          "servicePlan":"M2M_4G"
        }
      },
      "status":"Success",
      "callbackCount":1,
      "maxCallbackThreshold":4
    }
    

Failure Responses

Status 400

All error messages are returned in this format:

{
      "errorCode": "error code string",
      "errorMessage": "error message string"
    }