API Reference
## Disable a Local Profile on a Device 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](/docs/standard-apis/connectivity-management/api-endpoints/embedded-sim-including-consumer-esim/disable-local-profile/disablelocalprofile) 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 /session/login. | | Content-Type required | string | Must 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 | |:---------------------------------:|:--------------------------:|:-------------------------------------------------------------------------------------------------------:| | **devices** *(required)* | array of deviceIds objects | The EID and ICCID the device for which you want to disable a local profile. | | **kind, id** *(required for `devices`)* | strings | The type and value of the device identifier. This could be **EID** or **ICCID** <br> **Note:** the first letter will be capitalized and the rest of teh letters will be lower case. | | **accountName** *(required)* | string | The name of a billing account. An account name is usually numeric, and must include any leading zeros. | | **smsrOid** *(required)* | string | The Object ID of the SMSR system. | ### Example Request Body Request to disable the local profile on a device: ```json { "devices":[ { "deviceIds":[ { "kind":"Eid", "id":"30-digit EID" }, { "kind":"Iccid", "id":"20-digit ICCID" } ] } ], "accountName":"0000123456-00001", "smsrOid": "1.3.6.1.4.1.31746.1.500.200.101.5" } ``` ### Success Responses Status 200 | Parameter Name | Data Type | Description | |:--------------:|:---------:|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| | **requestId** | string | A unique string (UUID) 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 ```json { "requestId": "595f5c44-eeee-ffff-gggg-020a1545a84d" } ``` ### Example Success Callback Response ```json { "username":"user", "password":"password", "requestId":"595f5c44-eeee-ffff-gggg-020a1545a84d", "deviceIds":[ { "id":"15-digit IMEI", "kind":"imei" }, { "id":"30-digit EID", "kind":"eid" } ], "deviceResponse":{ "deviceProfileResponse":{ "deviceIdentifierCollection":[ { "id":"15-digit IMEI", "kind":"imei" }, { "id":"20-digit ICCID", "kind":"iccid" }, { "id":"10-digit phone number", "kind":"mdn" }, { "id":"30-digit EID", "kind":"eid" } ], "ipAddress":"10.0.1.216", "state":"Active", "servicePlan":"RP4235311", "deviceCredential":{ "username":"user name", "password":"password" }, "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 } ```