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 |
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: 20, max: 100) |
| sort | Sort field and direction (e.g., syncedAt,desc) |
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/countGet Asset
Returns detailed information about a specific asset by its ID, including all nested objects.
GET /assets/{id}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 | Full asset path in the hierarchy (e.g., enterprises/acme/assets/asset_abc123) |
| 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: