Premium APIsSoftware ManagementSoftware Management V2API Reference V2
Get device firmware upgrade history
Get a Device’s Software Upgrade History
GET /reports/{accountName}/devices/{deviceId}
Returns the software upgrade history of the specified device IMEI.
HTTP Request
GET https://thingspace.verizon.com/api/fota/v2/reports/{accountName}/devices/{deviceId}
Resource Path Parameters
You must include the account name and the device IMEI in the path.
| Parameter Name | Data Type | Description |
|---|---|---|
| accountName 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. |
Header Parameters
The request header must contain a current ThingSpace authorization token and a current VZ-M2M session token. For more details on how to get these tokens, visit Getting Started.
| Parameter Name | Data Type | Description |
|---|---|---|
| Authorization required | string | HTTP Authorization bearer token: Authorization: Bearer {token} |
| VZ-M2M-Token required | string | A valid session token: VZ-M2M-Token: {M2Mtoken} |
Request Body
None.
Example Request
Request the upgrade history of a device:
curl https://thingspace.verizon.com/api/fota/v2/reports/0402196254-00001/devices/990013907835573 -H 'Authorization: Bearer $AUTH_TOKEN' -H 'VZ-M2M-Token: $M2M_TOKEN'Success Responses
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. |
Example Success Response
[
{
"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"
}
]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.