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 |