Verizon 5G Edge API Portal
Verizon 5G EdgeThingSpace
HomeSDKsContext PluginAPI Reference
Software Management Reports V1

ListUpgradesForSpecifiedStatus

GET
/fota/v1/reports/{account}/status/{upgradeStatus}/index/{startIndex}

Returns a list of all upgrades with a specified status.

Authorization

thingspace_oauth VZ-M2M-Token
AuthorizationBearer <token>

This is the ThingSpace token, from Credentials and Tokens is used

In: header

VZ-M2M-Token<token>

M2M Session Token (How to generate an M2M session token?)

In: header

Path Parameters

account*string

Account identifier in "##########-#####".

upgradeStatus*UpgradeStatus

The status of the upgrades that you want to retrieve.

Value in

  • "RequestPending"
  • "Queued"
  • "RequestFailed"
  • "InProgress"
  • "Finished"
  • "UpgradeFailed"
startIndex*string

The zero-based number of the first record to return. Set startIndex=0 for the first request. If hasMoreFlag=true in the response, use the lastSeenUpgradeId value from the response as the startIndex in the next request.

Response Body

application/json

application/json

curl -X GET "https://example.com/fota/v1/reports/0242078689-00001/status/RequestPending/index/string"
{  "hasMoreFlag": false,  "lastSeenUpgradeId": 0,  "reportList": [    {      "id": "3ac8c863-bde7-4f41-878e-dd5473e973bb",      "accountName": "0242078689-00001",      "firmwareName": "FOTA_Verizon_Model-A_01To02_HF",      "firmwareTo": "VerizonFirmwareVersion-02",      "startDate": "2018-04-01",      "status": "Queued",      "deviceList": [        {          "deviceId": "900000000000002",          "status": "Device Accepted",          "resultReason": "success"        },        {          "deviceId": "900000000000003",          "status": "Device Accepted",          "resultReason": "success"        }      ]    },    {      "id": "efb8206b-2e88-4fdb-886d-31d8e87cd95f",      "accountName": "0242078689-00001",      "firmwareName": "FOTA_Verizon_Model-A_01To02_HF",      "firmwareTo": "VerizonFirmwareVersion-02",      "startDate": "2018-04-01T16:03:00.000Z",      "status": "Queued",      "deviceList": [        {          "deviceId": "900000000000008",          "status": "Device Accepted",          "resultReason": "success"        }      ]    }  ]}

Get list of devices in the account GET

Returns an array of all devices in the specified account. Each device object includes information needed for managing firmware, including the device make and model, MDN and IMEI, and current firmware version.

GetDeviceFirmwareUpgradeHistory GET

Returns the upgrade history of the specified device from the previous six months.