Assets API

Endpunkte für den Zugriff auf Asset-Informationen in Ihrem Unternehmen. Assets stellen Inventargegenstände dar, die möglicherweise als verwaltete Geräte registriert sind oder auch nicht.

Verfügbare Endpunkte

GET/api/v1/assets

Alle Assets mit Paginierung und Filterung auflisten

GET/api/v1/assets/count

Gesamtanzahl der Assets abrufen

GET/api/v1/assets/{assetId}

Details eines bestimmten Assets abrufen

GET/api/v1/assets

Gibt eine paginierte Liste von Assets mit optionaler Filterung zurück. Die Ergebnisse werden standardmäßig nach syncedAt absteigend sortiert.

Abfrageparameter

Name	Type	Required	Description
`status`	string	Optional	Nach Asset-Status filtern (z.B. ACTIVE, INACTIVE)
`policy`	string	Optional	Filtern nach zugewiesenem Richtlinienpfadnamen
`page`	integer	Optional	Seitennummer (0-indiziert, Standard: 0)(default: `0`)
`size`	integer	Optional	Seitengröße (Standard: 20, Maximum: 100)(default: `20`)
`sort`	string	Optional	Sortierfeld und Richtung (z.B. syncedAt,desc)

Request

curl -X GET "https://api.nomid.tech/emm/api/v1/assets?status=ACTIVE&page=0&size=20" \
  -H "X-API-Key: nm_acme_abc123..."

Responsejson

{
  "content": [
    {
      "pathName": "enterprises/acme/assets/asset_abc123",
      "identification": "Warehouse Scanner 01",
      "status": "ACTIVE",
      "syncedAt": "2026-01-29T08:15:00Z",
      "customData": {
        "metadata": {
          "department": "logistics",
          "location": "warehouse-a"
        },
        "tags": ["warehouse", "scanner", "critical"]
      },
      "specifications": {
        "imeis": ["123456789012345"],
        "serialNumber": "ABC123XYZ",
        "model": "Galaxy Tab Active3",
        "brand": "Samsung",
        "os": "Android",
        "osVersion": "13"
      },
      "managedDevice": {
        "pathName": "enterprises/acme/devices/device_xyz789",
        "name": "Warehouse Scanner 01",
        "status": "ACTIVE",
        "policyPathName": "enterprises/acme/policies/warehouse",
        "enrollmentTime": "2025-01-15T10:30:00Z"
      }
    }
  ],
  "totalElements": 156,
  "totalPages": 8,
  "size": 20,
  "number": 0
}

GET/api/v1/assets/count

Gibt die Gesamtzahl der Assets zurück, die den Filterkriterien entsprechen. Unterstützt dieselben Filterparameter wie der Listenendpunkt.

Request

curl -X GET "https://api.nomid.tech/emm/api/v1/assets/count?status=ACTIVE" \
  -H "X-API-Key: nm_acme_abc123..."

Responsejson

{
  "count": 156
}

GET/api/v1/assets/{assetId}

Gibt detaillierte Informationen zu einem bestimmten Asset anhand seiner ID zurück, einschließlich aller verschachtelten Objekte.

Request

curl -X GET "https://api.nomid.tech/emm/api/v1/assets/asset_abc123" \
  -H "X-API-Key: nm_acme_abc123..."

Antwortschema

Jedes Asset-Objekt folgt der PublicAssetDto-Struktur mit verschachtelten Objekten für benutzerdefinierte Daten, Hardware-Spezifikationen und verwaltete Geräteinformationen.

Felder auf oberster Ebene

Name	Type	Required	Description
`pathName`	string	Required	Vollständiger Asset-Pfad in der Hierarchie (z. B. enterprises/acme/assets/asset_abc123)
`identification`	string	Required	Benutzerfreundlicher Bezeichner oder Anzeigename für das Asset
`status`	string	Required	Aktueller Asset-Status (ACTIVE, INACTIVE usw.)
`syncedAt`	string	Required	ISO 8601 Zeitstempel der letzten Synchronisierung
`customData`	object	Optional	Objekt, das benutzerdefinierte Metadaten und Tags enthält
`specifications`	object	Optional	Objekt, das Hardware-Spezifikationen enthält
`managedDevice`	object \| null	Optional	Objekt, das EMM-Geräteinformationen enthält, oder null, wenn nicht registriert

customData Objekt

Name	Type	Required	Description
`metadata`	object	Optional	Schlüssel-Wert-Paare für benutzerdefinierte Metadaten (z. B. Abteilung, Standort)
`tags`	string[]	Optional	Array von String-Tags zur Kategorisierung

specifications Objekt

Name	Type	Required	Description
`imeis`	string[]	Optional	Array von Geräte-IMEI-Nummern
`serialNumber`	string	Optional	Geräte-Seriennummer
`model`	string	Optional	Geräte-Modellname
`brand`	string	Optional	Gerätehersteller/-marke
`os`	string	Optional	Name des Betriebssystems (z. B. Android)
`osVersion`	string	Optional	Betriebssystemversion

Verwaltetes Geräteobjekt

Dieses Objekt ist null, wenn das Asset nicht als verwaltetes Gerät im EMM-System registriert ist.

Name	Type	Required	Description
`pathName`	string	Required	Gerätepfad im EMM-System
`name`	string	Required	Geräteanzeigename in EMM
`status`	string	Required	EMM-Gerätestatus (AKTIV, BEREITSTELLUNG, DEAKTIVIERT usw.)
`policyPathName`	string	Required	Pfad der zugewiesenen Richtlinie
`enrollmentTime`	string	Required	ISO 8601-Zeitstempel, wann das Gerät registriert wurde

Paginierung

Listen-Endpunkte geben paginierte Ergebnisse im Spring Page-Format zurück:

content - Array von Asset-Objekten für die aktuelle Seite
totalElements - Gesamtzahl der Assets, die der Abfrage entsprechen
totalPages - Gesamtzahl der verfügbaren Seiten
size - Angefragte Seitengröße
number - Aktuelle Seitennummer (0-basiert)

Hinweis

Maximale Seitengröße beträgt 100. Anfragen mit Größe > 100 werden auf 100 begrenzt.

Name

Type

Required

Description

status

string

Optional

Nach Asset-Status filtern (z.B. ACTIVE, INACTIVE)

policy

string

Optional

Filtern nach zugewiesenem Richtlinienpfadnamen

page

integer

Optional

Seitennummer (0-indiziert, Standard: 0)(default: 0)

size

integer

Optional

Seitengröße (Standard: 20, Maximum: 100)(default: 20)

sort

string

Optional

Sortierfeld und Richtung (z.B. syncedAt,desc)

{ "content": [ { "pathName": "enterprises/acme/assets/asset_abc123", "identification": "Warehouse Scanner 01", "status": "ACTIVE", "syncedAt": "2026-01-29T08:15:00Z", "customData": { "metadata": { "department": "logistics", "location": "warehouse-a" }, "tags": ["warehouse", "scanner", "critical"] }, "specifications": { "imeis": ["123456789012345"], "serialNumber": "ABC123XYZ", "model": "Galaxy Tab Active3", "brand": "Samsung", "os": "Android", "osVersion": "13" }, "managedDevice": { "pathName": "enterprises/acme/devices/device_xyz789", "name": "Warehouse Scanner 01", "status": "ACTIVE", "policyPathName": "enterprises/acme/policies/warehouse", "enrollmentTime": "2025-01-15T10:30:00Z" } } ], "totalElements": 156, "totalPages": 8, "size": 20, "number": 0 }

Antwortschema

Jedes Asset-Objekt folgt der PublicAssetDto-Struktur mit verschachtelten Objekten für benutzerdefinierte Daten, Hardware-Spezifikationen und verwaltete Geräteinformationen.

Felder auf oberster Ebene

Name	Type	Required	Description
`pathName`	string	Required	Vollständiger Asset-Pfad in der Hierarchie (z. B. enterprises/acme/assets/asset_abc123)
`identification`	string	Required	Benutzerfreundlicher Bezeichner oder Anzeigename für das Asset
`status`	string	Required	Aktueller Asset-Status (ACTIVE, INACTIVE usw.)
`syncedAt`	string	Required	ISO 8601 Zeitstempel der letzten Synchronisierung
`customData`	object	Optional	Objekt, das benutzerdefinierte Metadaten und Tags enthält
`specifications`	object	Optional	Objekt, das Hardware-Spezifikationen enthält
`managedDevice`	object \| null	Optional	Objekt, das EMM-Geräteinformationen enthält, oder null, wenn nicht registriert

customData Objekt

Name	Type	Required	Description
`metadata`	object	Optional	Schlüssel-Wert-Paare für benutzerdefinierte Metadaten (z. B. Abteilung, Standort)
`tags`	string[]	Optional	Array von String-Tags zur Kategorisierung

specifications Objekt

Name	Type	Required	Description
`imeis`	string[]	Optional	Array von Geräte-IMEI-Nummern
`serialNumber`	string	Optional	Geräte-Seriennummer
`model`	string	Optional	Geräte-Modellname
`brand`	string	Optional	Gerätehersteller/-marke
`os`	string	Optional	Name des Betriebssystems (z. B. Android)
`osVersion`	string	Optional	Betriebssystemversion

Verwaltetes Geräteobjekt

Dieses Objekt ist null, wenn das Asset nicht als verwaltetes Gerät im EMM-System registriert ist.

Name	Type	Required	Description
`pathName`	string	Required	Gerätepfad im EMM-System
`name`	string	Required	Geräteanzeigename in EMM
`status`	string	Required	EMM-Gerätestatus (AKTIV, BEREITSTELLUNG, DEAKTIVIERT usw.)
`policyPathName`	string	Required	Pfad der zugewiesenen Richtlinie
`enrollmentTime`	string	Required	ISO 8601-Zeitstempel, wann das Gerät registriert wurde

Paginierung

Listen-Endpunkte geben paginierte Ergebnisse im Spring Page-Format zurück:

content - Array von Asset-Objekten für die aktuelle Seite

totalElements - Gesamtzahl der Assets, die der Abfrage entsprechen

totalPages - Gesamtzahl der verfügbaren Seiten

size - Angefragte Seitengröße

number - Aktuelle Seitennummer (0-basiert)

Hinweis

Maximale Seitengröße beträgt 100. Anfragen mit Größe > 100 werden auf 100 begrenzt.