Get Offering of Device Type

GET 
/api/v1/catalog/offering/device-type/:deviceTypeIdentifier

This service message allows retrieval of the offering of a specific device type by device token and also optionally specify a specific platform.

Request

Path Parameters

deviceTypeIdentifier stringrequired

Device type identifier (ID or name)

Query Parameters

platformIdentifier string

Platform identifier (ID or name)

Responses

200

application/json

Schema

Schema

deviceTypeId numberrequired

ID of the device type

deviceTypeName stringrequired

Name of the device type

projects

object[]

Array [

projectName stringrequired

Name of the project

projectId numberrequired

Identifier of the project

displayName string

Display name of the project

label string

Label of the project

release

object

id stringrequired

version stringrequired

projectName stringrequired

releaseNotes string

metadata object

status stringrequired

Possible values: [draft, in_review, approved, released, archived]

type stringrequired

Possible values: [product, formation]

size int64

createdAt date-timerequired

updatedAt date-timerequired

latest boolean

releasedAt date-time

]

Example (from schema)

{
  "deviceTypeId": 0,
  "deviceTypeName": "string",
  "projects": [
    {
      "projectName": "string",
      "projectId": 0,
      "displayName": "string",
      "label": "string",
      "release": {
        "id": "string",
        "version": "string",
        "projectName": "string",
        "releaseNotes": "string",
        "metadata": {},
        "status": "draft",
        "type": "product",
        "size": 0,
        "createdAt": "2026-01-01T11:09:06.542Z",
        "updatedAt": "2026-01-01T11:09:06.542Z",
        "latest": true,
        "releasedAt": "2026-01-01T11:09:06.542Z"
      }
    }
  ]
}

Loading...