Get device offering
GET/api/v2/device/offering
Returns the software offerings available to this device, grouped by project.
Each project contains one or more releases with policy availability information.
When include_updates is enabled, releases that are currently downloading,
deploying, or already installed are included with their real-time status.
Request
Query Parameters
Skip policy enforcement; availability will be null on all releases
Include releases that are currently being delivered, deployed, or already installed on the device.
When false (default), only available offerings are returned
When true, the response also includes releases that are in progress (downloading, deploying, etc.) or already installed, alongside any available offerings.
Responses
- 200
- 404
- 500
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
Display name of the project
Label of the project
Identifier of the project
Name of the project
All releases offered for this project
[
{
"displayName": "string",
"label": "string",
"projectId": 0,
"projectName": "string",
"releases": [
{
"createdAt": "2026-04-22T16:58:12.263Z",
"dependencies": [
null
],
"displayName": "string",
"id": "string",
"label": "string",
"latest": true,
"metadata": {},
"policies": [
null
],
"projectId": 0,
"projectName": "string",
"releaseNotes": "string",
"releasedAt": "2026-04-22T16:58:12.263Z",
"size": 0,
"status": "draft",
"type": "product",
"updatedAt": "2026-04-22T16:58:12.263Z",
"version": "string",
"availability": {
"notOfferedReason": "string",
"offered": true,
"unavailable": true,
"unavailableReason": "string"
},
"deviceRelease": {
"artsDirPath": "string",
"deliveryState": "prepare",
"downloadDuration": 0,
"errMsg": "string",
"eta": 0,
"progress": 0,
"state": "offering",
"status": "Start"
}
}
]
}
]
- application/json
- Schema
- Example (from schema)
Schema
{
"message": "string",
"name": "string",
"statusCode": 0
}
- application/json
- Schema
- Example (from schema)
Schema
{
"message": "string",
"name": "string",
"statusCode": 0
}