# 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}](/docs/premium-apis/software-management/software-management-v1/api-endpoints/software-management-reports-v1/getdevicefirmwareupgradehistory) ### Resource Path Parameters You must include the account name and the device IMEI in the path. | Parameter Name | Data Type | Description | |:----------------|:-----------|:-------------| | **accountName** <br> *required* | string | The name of the account. An account name is usually numeric, and must include any leading zeros. | | **deviceId** <br> *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](https://thingspace.verizon.com/documentation/api-documentation.html#/http/session-management/guides/getting-started). | Parameter Name | Data Type | Description | |:-----------------------|:-----------|:-----------------------------------------------------------------------------| | **Authorization** <br> _required_ | string | HTTP Authorization bearer token: <br> `Authorization: Bearer {token}` | | **VZ-M2M-Token** <br> _required_ | string | A valid session token: <br> `VZ-M2M-Token: {M2Mtoken}` | ## Request Body None. ## Example Request Request the upgrade history of a device: ```json 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 ```json [ { "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: ```json { "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.