Get a List of Available Files

Get a List of Available Files

GET /files/{acc}

Retrieves a list of available files.

Uses and Requirements

You can retrieve a list of configuration or supplementary of files for an account.

See also:

Upload a New File 
Schedule a File Upgrade

Request Components

HTTP Request

GET https://thingspace.verizon.com/api/fota/v2/files/{acc}

Resource Path and Query Parameters

You must include the account name in the path.

Parameter Name Data Type Description
acc
required
(path)
string Account identifier.
distributionType
required
(query)
string Filter the distributionType to only retrieve files for a specific distribution type. Valid values include:
  • LWM2M
  • OMD-DM
  • HTTP

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 Parameters

None

Example Request

  
curl https://thingspace.verizon.com/api/fota/v2/files/0402196254-00001/HTTP  -H 'Authorization: Bearer $AUTH_TOKEN' -H 'VZ-M2M-Token: $M2M_TOKEN'}

 

Success Responses

Status 200

Parameter Name Data Type Description
     
fileName
required
string The name of the file you are upgrading to.
fileVersion
required
string The version of the file you are upgrading to.
distributionType
required
string Valid values include:
  • OMA
  • HTTP
launchDate string($date-time) Software launch date.
releaseNote
required
string Software release note.
make
required
string Software-applicable device make.
model
required
string Software-applicable device model.
localTargetPath string Local target path on the device.
distributionType
required
string Valid values include:
  • OMA
  • HTTP
devicePlatformId
required
string The platform (Android, iOS, etc.,) that the software can be applied to.

Example Success Response

[
  {
    "fileName": "string",
    "fileVersion": "string",
    "launchDate": "2021-02-09T16:18:18.208Z",
    "releaseNote": "string",
    "make": "string",
    "model": "string",
    "localTargetPath": "string",
    "distributionType": "string",
    "devicePlatformId": "string"
  }
]

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.