Assets API

Endpoints for accessing asset information in your organization. Assets represent inventory items that may or may not be enrolled as managed devices.

Available Endpoints

Method	Endpoint	Description
GET	/assets	List all assets with pagination and filtering
GET	/assets/count	Get total count of assets
GET	/assets/{id}	Get details of a specific asset
GET	/assets/summary	Get aggregate fleet numbers: totals, a status breakdown and a security posture summary
GET	/assets/{id}/commands	List the most recent commands sent to a device

List Assets

Returns a paginated list of assets with optional filtering. Results are sorted by syncedAt descending by default.

Query Parameters

Field	Description
status	Filter by asset status (e.g., ACTIVE, INACTIVE)
policy	Filter by assigned policy path name
page	Page number (0-indexed, default: 0)
size	Page size (default: 50, max: 100)
sort	Sort field and direction (e.g., syncedAt,desc)
lastSeenBefore	Only assets last seen before this ISO-8601 instant, for example 2026-01-01T00:00:00Z. It must not be in the future or before 1970-01-01T00:00:00Z. Also supported by /assets/count.

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

Get Asset Count

Returns the total count of assets matching the filter criteria. Supports the same filter parameters as the list endpoint.

GET /assets/count

Get Asset

Returns detailed information about a specific asset by its ID, including all nested objects.

GET /assets/{id}

Find devices not seen recently

lastSeenBefore narrows a list or a count to devices whose record was last updated before the instant you give, which is a practical way to find offline devices. It works at minute granularity, so a device updated up to 59 seconds after the instant may still be included.

curl "https://api.nomid.tech/emm/api/v1/assets?lastSeenBefore=2026-09-01T00:00:00Z&status=ACTIVE" \
  -H "X-API-Key: $NOMID_API_KEY"

Fleet summary

GET /assets/summary needs DEVICES_READ and returns aggregate numbers only, never a device list.

totalDevices	Total number of devices.
devicesByStatus	Device counts keyed by status.
securityPosture	Security counts such as secureCount, atRiskCount and potentiallyCompromisedCount. riskyDeviceIds lists up to 10 device path names, worst first. riskyDeviceCount is the true total, and riskyDeviceIdsTruncated says whether the list was cut.

The security posture counts exclude Pico devices. The top-level totalDevices does not.

Command history

GET /assets/ASSET_ID/commands needs DEVICES_READ and returns the most recent commands sent to a device, newest first. limit defaults to 20 and is capped at 50. A limit below 1 returns 400, and an unknown asset returns 404.

type	The command type, for example LOCK or NOTIFICATION_MESSAGE.
status	IN_PROGRESS, EXPIRED, SUCCESS or ERROR.
createdAt	When the command was created.
feedbackAt	When the device or provider reported back, if it has.
outcome	A short code that explains an ERROR or EXPIRED status.

curl "https://api.nomid.tech/emm/api/v1/assets/k3x9m2pa/commands?limit=5" \
  -H "X-API-Key: $NOMID_API_KEY"

Command payloads and sensitive data are never returned.

Send commands with the device commands API

Response Schema

Each asset object follows the PublicAssetDto structure with nested objects for custom data, hardware specifications, and managed device information.

Top-Level Fields

pathName	Unique asset identifier: a short code such as k3x9m2pa, with no slashes. Use it as the asset ID in URLs, for example /assets/k3x9m2pa.
identification	User-friendly identifier or display name for the asset
status	Current asset status (ACTIVE, INACTIVE, etc.)
syncedAt	ISO 8601 timestamp of last synchronization
customData	Object containing custom metadata and tags
specifications	Object containing hardware specifications
managedDevice	Object containing EMM device info, or null if not enrolled

customData Object

Key-value pairs of custom metadata (e.g., department, location)

Array of string tags for categorization

specifications Object

Device serial number

Device model name

managedDevice Object

This object is null when the asset is not enrolled as a managed device in the EMM system.

Pagination

List endpoints return paginated results using Spring's Page format: