Policies API
Endpoints for accessing policy metadata in your organization.
GET
/policiesList Policies
Returns a list of all policies in your organization with metadata.
Request
curl -X GET "https://api.nomid.tech/emm/api/v1/policies" \
-H "X-API-Key: nm_acme_abc123..."Responsejson
[
{
"pathName": "enterprises/acme/policies/warehouse",
"displayName": "Warehouse Policy",
"description": "Policy for warehouse scanner devices",
"version": 3,
"providerVersion": "1.2.0",
"mainGroup": "Operations"
},
{
"pathName": "enterprises/acme/policies/retail",
"displayName": "Retail Store Policy",
"description": "Policy for retail POS devices",
"version": 5,
"providerVersion": "1.2.0",
"mainGroup": "Retail"
},
{
"pathName": "enterprises/acme/policies/field",
"displayName": "Field Workers Policy",
"description": "Policy for field service technicians",
"version": 2,
"providerVersion": "1.1.0",
"mainGroup": "Field Services"
}
]GET
/policies/{policyId}Get Policy
Returns detailed metadata for a specific policy by its path name.
The policy ID contains forward slashes, so it must be URL-encoded. Use encodeURIComponent() in JavaScript or urllib.parse.quote() in Python.
Request
curl -X GET "https://api.nomid.tech/emm/api/v1/policies/enterprises%2Facme%2Fpolicies%2Fwarehouse" \
-H "X-API-Key: nm_acme_abc123..."Responsejson
{
"pathName": "enterprises/acme/policies/warehouse",
"displayName": "Warehouse Policy",
"description": "Policy for warehouse scanner devices",
"version": 3,
"providerVersion": "1.2.0",
"mainGroup": "Operations"
}Security Note
Policy configuration details are NOT exposed via the public API for security reasons. Only metadata about policies is returned. Configuration management should be done through the Nomid Portal.
Response Fields
| Field | Type | Description |
|---|---|---|
| pathName | string | Full policy path in the hierarchy (e.g., enterprises/acme/policies/warehouse) |
| displayName | string | Human-readable policy name |
| description | string | Policy description text |
| version | integer | Policy version number (increments on each update) |
| providerVersion | string | MDM provider version this policy is compatible with |
| mainGroup | string | Policy group name for organizational categorization |