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

GET/api/v1/assets

List all assets with pagination and filtering

GET/api/v1/assets/count

Get total count of assets

GET/api/v1/assets/{assetId}

Get details of a specific asset

GET/api/v1/assets

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

Query Parameters

Name	Type	Required	Description
`status`	string	Optional	Filter by asset status (e.g., ACTIVE, INACTIVE)
`policy`	string	Optional	Filter by assigned policy path name
`page`	integer	Optional	Page number (0-indexed, default: 0)(default: `0`)
`size`	integer	Optional	Page size (default: 20, max: 100)(default: `20`)
`sort`	string	Optional	Sort field and direction (e.g., 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

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

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}

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

Request

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

Response Schema

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

Top-Level Fields

Name	Type	Required	Description
`pathName`	string	Required	Full asset path in the hierarchy (e.g., enterprises/acme/assets/asset_abc123)
`identification`	string	Required	User-friendly identifier or display name for the asset
`status`	string	Required	Current asset status (ACTIVE, INACTIVE, etc.)
`syncedAt`	string	Required	ISO 8601 timestamp of last synchronization
`customData`	object	Optional	Object containing custom metadata and tags
`specifications`	object	Optional	Object containing hardware specifications
`managedDevice`	object \| null	Optional	Object containing EMM device info, or null if not enrolled

customData Object

Name	Type	Required	Description
`metadata`	object	Optional	Key-value pairs of custom metadata (e.g., department, location)
`tags`	string[]	Optional	Array of string tags for categorization

specifications Object

Name	Type	Required	Description
`imeis`	string[]	Optional	Array of device IMEI numbers
`serialNumber`	string	Optional	Device serial number
`model`	string	Optional	Device model name
`brand`	string	Optional	Device manufacturer/brand
`os`	string	Optional	Operating system name (e.g., Android)
`osVersion`	string	Optional	Operating system version

managedDevice Object

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

Name	Type	Required	Description
`pathName`	string	Required	Device path in the EMM system
`name`	string	Required	Device display name in EMM
`status`	string	Required	EMM device status (ACTIVE, PROVISIONING, DISABLED, etc.)
`policyPathName`	string	Required	Path of the assigned policy
`enrollmentTime`	string	Required	ISO 8601 timestamp when device was enrolled

Pagination

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

content - Array of asset objects for the current page
totalElements - Total number of assets matching the query
totalPages - Total number of pages available
size - Requested page size
number - Current page number (0-indexed)

Note

Maximum page size is 100. Requests with size > 100 will be capped to 100.

Name

Type

Required

Description

status

string

Optional

Filter by asset status (e.g., ACTIVE, INACTIVE)

policy

string

Optional

Filter by assigned policy path name

page

integer

Optional

Page number (0-indexed, default: 0)(default: 0)

size

integer

Optional

Page size (default: 20, max: 100)(default: 20)

sort

string

Optional

Sort field and direction (e.g., 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 }

Response Schema

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

Top-Level Fields

Name	Type	Required	Description
`pathName`	string	Required	Full asset path in the hierarchy (e.g., enterprises/acme/assets/asset_abc123)
`identification`	string	Required	User-friendly identifier or display name for the asset
`status`	string	Required	Current asset status (ACTIVE, INACTIVE, etc.)
`syncedAt`	string	Required	ISO 8601 timestamp of last synchronization
`customData`	object	Optional	Object containing custom metadata and tags
`specifications`	object	Optional	Object containing hardware specifications
`managedDevice`	object \| null	Optional	Object containing EMM device info, or null if not enrolled

customData Object

Name	Type	Required	Description
`metadata`	object	Optional	Key-value pairs of custom metadata (e.g., department, location)
`tags`	string[]	Optional	Array of string tags for categorization

specifications Object

Name	Type	Required	Description
`imeis`	string[]	Optional	Array of device IMEI numbers
`serialNumber`	string	Optional	Device serial number
`model`	string	Optional	Device model name
`brand`	string	Optional	Device manufacturer/brand
`os`	string	Optional	Operating system name (e.g., Android)
`osVersion`	string	Optional	Operating system version

managedDevice Object

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

Name	Type	Required	Description
`pathName`	string	Required	Device path in the EMM system
`name`	string	Required	Device display name in EMM
`status`	string	Required	EMM device status (ACTIVE, PROVISIONING, DISABLED, etc.)
`policyPathName`	string	Required	Path of the assigned policy
`enrollmentTime`	string	Required	ISO 8601 timestamp when device was enrolled

Pagination

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

content - Array of asset objects for the current page

totalElements - Total number of assets matching the query

totalPages - Total number of pages available

size - Requested page size

number - Current page number (0-indexed)

Note

Maximum page size is 100. Requests with size > 100 will be capped to 100.