Premium APIsSoftware ManagementSoftware Management V2API Reference V2
Get a list of available software
GET /software/{accountName}
Allows you to retrieve a list of available software for your account.
HTTP Request
GET https://thingspace.verizon.com/api/fota/v2/software/{accountName}
Resource Path and Query Parameters
| Parameter Name | Data Type | Description |
|---|---|---|
| accountName required | string | Account identifier. |
| distributionType query | string | Filter to retrieve a specific type of software. Valid values include:
|
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 a list of available software for your account.
curl https://thingspace.verizon.com/api/fota/v2/software/0402196254-00001 -H 'Authorization: Bearer $AUTH_TOKEN' -H 'VZ-M2M-Token: $M2M_TOKEN'Success Responses
Status 200
| Parameter Name | Data Type | Description |
|---|---|---|
| softwareName | string | The software name. |
| launchDate | string | The software launch date. |
| releaseNote | string | Software release note reserved for future use. |
| model | string | Software device model. |
| make | string | Software device make. |
| distributionType | string | The distribution type. Valid values include:
|
| devicePlatformId | string | The platform (Android, iOS, IoT, for example) that the software can be applied to. |
Example Success Response
An array of software for your account is returned in the response.
[
{
"software":"FOTA_Verizon_Model-A_02To03_HF",
"launchDate":"2020-08-31 00:00:00 +0000 UTC",
"releaseNote":"",
"model":"Model-A",
"make":"Verizon",
"distributionType":"HTTP",
"devicePlatformId": "IoT"
}
]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.