Disable a Local Profile on a Device:

`POST /devices/profile/actions/disable`

Disables a downloaded eUICC local profile on a device.

NOTE: This API endpoint is currently in limited release, and is not yet available to all customer accounts.

Disable a Local Profile on a Device:
POST /devices/profile/actions/disable

Uses and Requirements

A device with a disabled profile cannot connect to the Verizon Wireless network in local mode. The device connectivity reverts back to the bootstrap (fallback) profile, which allows it to connect to the Verizon Wireless network in roaming mode as per the roaming agreement.

ThingSpace sends an asynchronous DeviceProfileResponse callback message when it receives a response from the SM-SR system about a profile state change. If a time-out situation occurs, such as when a device is unreachable, the initial callback will include a “warning” status, and a later response will indicate either success or failure.

Request Components

HTTP Request

POST https://thingspace.verizon.com/api/m2m/v1/devices/profile/actions/disable

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
Parameter NameAuthorization required	Data Typestring	DescriptionHTTP Authorization bearer token.
Parameter NameVZ-M2M-Token required	Data Typestring	DescriptionA valid session token returned by POST /session/login.
Parameter NameContent-Type required	Data Typestring	DescriptionMust be `application/json`.

Request Body

The request body identifies the device on which you want to disable the local profile.

Parameter Name	Data Type	Description
Parameter Namedevices required	Data Typearray of deviceIds objects	DescriptionThe EID and ICCID the device for which you want to disable a local profile.
Parameter Name kind, id required for devices	Data Typestrings	DescriptionThe type and value of the device identifier. EID (required) ICCID (required)
Parameter NameaccountName required	Data Typestring	DescriptionThe name of a billing account. An account name is usually numeric, and must include any leading zeros.
Parameter NamesmsrOid required	Data Typestring	DescriptionThe Object ID of the SMSR system.

Example Request Body

Request to disable the local profile on a device:

{
  "devices":[  
    {
      "deviceIds":[
        {  
          "kind":"eid",
          "id":"666456789123456789123456784008"
        },
        {  
          "kind":"iccid",
          "id":"89148000000840784259"
        }
      ]
    }
  ],
  "accountName":"1223334444-00001",
  "smsrOid": "
}

Success Responses

Status 200

Parameter Name	Data Type	Description
Parameter NamerequestId	Data Typestring	DescriptionA unique string that associates the request with the results that are sent via a callback message. ThingSpace will send a separate callback message for each device that was in the request indicating whether the operation succeeded for that device. All of the callback messages will have the same requestId.

Example Success Response

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

Example Success Callback Response

{
  "username":"user",
  "password":"user",
  "requestId":"595f5c44-c31c-4552-8670-020a1545a84d",
  "deviceIds":[  
    {  
      "id":"666456789014008",
      "kind":"imei"
    },
    {  
      "id":"666456789123456789123456784008",
      "kind":"eid"
    }
  ],
  "deviceResponse":{  
    "deviceProfileResponse":{  
      "deviceIdentifierCollection":[  
        {  
          "id":"666456789014008",
          "kind":"imei"
        },
        {  
          "id":"11245055053268336886",
          "kind":"iccid"
        },
        {  
          "id":"2022326360",
          "kind":"mdn"
        },
        {  
          "id":"666456789123456789123456784008",
          "kind":"eid"
        }
      ],
      "ipAddress":"101.0.1.216",
      "state":"Active",
      "servicePlan":"RP4235311",
      "deviceCredential":{  
        "username":"2022326360@vzw4g.com",
        "password":"2022326360"
      },
      "smsrOid":"1.3.6.1.4.1.31746.1.500.200.101.5",
      "profileStatus":"disable",
      "euiccStatus":"EXECUTED_SUCCESS",
      "euiccStatusCode":"1.2.365",
      "euiccStatusDesc":"EUICC device profile has been updated"
    }
  },
  "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"
}

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

Try It Out!