GET /reports/{acc}/devices/{deviceId}Returns the software upgrade history of the specified device IMEI.
GET https://thingspace.verizon.com/api/fota/v2/reports/{acc}/devices/{deviceId}
You must include the account name and the device IMEI in the path.
| Parameter Name | Data Type | Description |
|---|---|---|
| acc required |
string | The name of the account. An account name is usually numeric, and must include any leading zeros. |
| deviceId required |
string | The IMEI of the device for which you want the upgrade history. |
The request header must contain a current ThingSpace authorization token and a current VZ-M2M session token.
| Parameter Name | Data Type | Description |
|---|---|---|
| Authorization required |
string | HTTP Authorization request header containing a valid Bearer token. |
| VZ-M2M-Token required |
string | A valid session token returned by a Connectivity Management POST /session/login request. |
None.
Request the upgrade history of a device:
curl https://{{<hostUrl>}}/api/fota/v2/reports/0402196254-00001/devices/990013907835573 -H 'Authorization: Bearer $AUTH_TOKEN' -H 'VZ-M2M-Token: $M2M_TOKEN'
Status 200
A success response contains an array of software upgrades that the device has had, and each upgrade object has these details:
| Parameter Name | Data Type | Description |
|---|---|---|
| deviceId | string | The IMEI of the device. |
| id | UUID string | The unique identifier for the upgrade. |
| accountName | string | The name (number) of the billing account. |
| softwareName | string | The software name. |
| startDate | string | Software upgrade start date. |
| status | string | The status of the upgrade for this device, either UpgradeSuccess or UpgradeFailed. |
| reason | string | More information about the status. |
[
{
"deviceId": "990013907835573",
"id": "60b5d639-ccdc-4db8-8824-069bd94c95bf",
"accountName": "0402196254-00001",
"softwareName": "FOTA_Verizon_Model-A_02To03_HF",
"startDate": "2018-03-05",
"upgradeStartTime": "2018-03-05T19:07:21Z",
"status": "UpgradeSuccess",
"reason": "success"
},
{
"deviceId": "990013907835573",
"id": "50d5d639-aaca-3ca7-7713-958ac83b84ae",
"accountName": "0402196254-00001",
"softwareName": "VerizonSoftwareVersion-01",
"startDate": "2018-02-20",
"upgradeStartTime": "2018-02-20T00:03:19Z",
"status": "UpgradeSuccess",
"reason": "success"
}
]
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.