Get a Device’s Software Upgrade History

Get a Device's Software Upgrade History

GET /reports/{acc}/devices/{deviceId}

Returns the software upgrade history of the specified device IMEI.

Request Components

HTTP Request

GET https://thingspace.verizon.com/api/fota/v2/reports/{acc}/devices/{deviceId}

Resource Path Parameters

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.

Header Parameters

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.

Request Body

None.

Example Request

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'

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.