Getting Started

Get up and running with the Nomid MDM API in just a few minutes. This guide will walk you through authentication setup and making your first API call.

Prerequisites

A Nomid MDM account with administrator access
Access to the Company Settings in the Portal
A tool to make HTTP requests (curl, Postman, or your preferred language)

Step 1: Create an API Key

Log in to the Nomid Portal at portal.nomid.tech
Navigate to Company Settings > Integrations
Click 'Create API Key' and give it a descriptive name
Copy the API key - it will only be shown once!

Important

Store your API key securely. It will only be displayed once upon creation. If you lose it, you'll need to create a new one.

Step 2: Make Your First Request

Use your API key to authenticate requests. Include it in the X-API-Key header:

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

Tip

You can test these examples directly in your terminal or browser console. Make sure to replace the API key with your own.

Step 3: Handle the Response

The API returns JSON responses. Here's an example response from the devices endpoint:

Responsejson

{
  "content": [
    {
      "pathName": "enterprises/acme/assets/asset_123abc",
      "identification": "Warehouse-Scanner-01",
      "status": "ACTIVE",
      "syncedAt": "2026-01-20T14:22:00Z",
      "customData": {
        "metadata": { "department": "Warehouse", "location": "Building A" },
        "tags": ["scanner", "warehouse"]
      },
      "specifications": {
        "imeis": ["123456789012345"],
        "serialNumber": "ABC123456",
        "model": "TC52",
        "brand": "Zebra",
        "os": "Android",
        "osVersion": "13"
      },
      "managedDevice": {
        "pathName": "enterprises/acme/devices/device_123abc",
        "name": "devices/device_123abc",
        "status": "ACTIVE",
        "policyPathName": "enterprises/acme/policies/warehouse",
        "enrollmentTime": "2026-01-15T10:30:00Z"
      }
    }
  ],
  "totalElements": 1,
  "totalPages": 1,
  "size": 20,
  "number": 0
}

Responses are paginated. Use the 'page' and 'size' query parameters to navigate through results.

Rate Limits

The API includes rate limit headers in every response. Monitor these to avoid hitting limits.

Header	Description
X-RateLimit-Limit	Maximum requests allowed per minute
X-RateLimit-Remaining	Requests remaining in the current window
X-RateLimit-Reset	Unix timestamp when the rate limit resets

Next Steps

Explore Asset Endpoints Learn About Policies

Step 1: Create an API Key

Navigate to Company Settings > Integrations

Click 'Create API Key' and give it a descriptive name

Copy the API key - it will only be shown once!

Important

Store your API key securely. It will only be displayed once upon creation. If you lose it, you'll need to create a new one.

Step 2: Make Your First Request

Use your API key to authenticate requests. Include it in the X-API-Key header:

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

Tip

You can test these examples directly in your terminal or browser console. Make sure to replace the API key with your own.

Step 3: Handle the Response

The API returns JSON responses. Here's an example response from the devices endpoint:

Responsejson

{
  "content": [
    {
      "pathName": "enterprises/acme/assets/asset_123abc",
      "identification": "Warehouse-Scanner-01",
      "status": "ACTIVE",
      "syncedAt": "2026-01-20T14:22:00Z",
      "customData": {
        "metadata": { "department": "Warehouse", "location": "Building A" },
        "tags": ["scanner", "warehouse"]
      },
      "specifications": {
        "imeis": ["123456789012345"],
        "serialNumber": "ABC123456",
        "model": "TC52",
        "brand": "Zebra",
        "os": "Android",
        "osVersion": "13"
      },
      "managedDevice": {
        "pathName": "enterprises/acme/devices/device_123abc",
        "name": "devices/device_123abc",
        "status": "ACTIVE",
        "policyPathName": "enterprises/acme/policies/warehouse",
        "enrollmentTime": "2026-01-15T10:30:00Z"
      }
    }
  ],
  "totalElements": 1,
  "totalPages": 1,
  "size": 20,
  "number": 0
}

Responses are paginated. Use the 'page' and 'size' query parameters to navigate through results.

Header

Description

X-RateLimit-Limit

Maximum requests allowed per minute

X-RateLimit-Remaining

Requests remaining in the current window

X-RateLimit-Reset

Unix timestamp when the rate limit resets