List Apple enrollment templates

GET

/v1/organizations/:organizationId/mdm/apple/enterprise/enrollment-templates/

List Apple enrollment templates

Required Permission: mdm.apple.enrollmentTemplate.list

Retrieves a paginated list of Apple device enrollment templates configured for the organization.

Request

Add parameter in header authorization

Example: Authorization: Bearer <token>

organizationId string

required

Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

page integer

optional

Page number for pagination navigation through enrollment template results.

limit integer

optional

Maximum number of enrollment template records returned per page.

sort string

optional

Ordering criteria using a field-to-direction mapping to organize results based on specific attributes like creation date, name, or status.

Match pattern: ^[\w.]*((:asc)|(:desc))?$

name string

optional

Human-readable enrollment template name identifying configuration purpose for device onboarding workflows.

≤ 128 characters

segmentId integer

optional

expandTo string

optional

ancestorschildren

Responses

200 Response application/json

status boolean optional

data object optional

items array [object] optional

id string optional

Unique identifier for Apple enrollment template configuration within organizational MDM deployment.

Match pattern: ^[a-fA-F0-9]{24}$

name string optional

Human-readable enrollment template name identifying configuration purpose for device onboarding workflows.

≤ 128 characters

description string optional

Detailed enrollment template description explaining purpose, target devices, and configuration policies for administrators.

≤ 256 characters

rules array [object] optional

Array of enrollment rules defining conditional device configurations, policies, and automated actions during onboarding.

name string optional

Rule name identifying specific device configuration policy within enrollment template workflow.

≤ 256 characters

displayNamePattern string optional

Device naming pattern template using placeholders for automatic device name generation during enrollment.

≤ 256 characters

setDeviceName boolean optional

Flag enabling automatic device naming based on displayNamePattern during enrollment process.

tags array [string] optional

Classification tags applied to devices enrolled with this rule for organization and policy targeting.

conditions array [object] optional

Conditional criteria array determining when specific enrollment rule applies during device onboarding workflow.

tags array [array] optional

Nested tag arrays defining AND/OR logic for rule activation based on device or user tag matching.

auxiliaryFields array [array] optional

Nested auxiliary field arrays defining conditional logic for rule activation based on custom user data.

patterns array [string] optional

Regular expression patterns for conditional rule activation based on device or user attribute matching.

identifiers array [string] optional

Specific device or user identifiers triggering conditional rule activation during enrollment workflow.

admPolicyId string optional

Apple Device Management policy identifier linking enrollment rule to device configuration and restriction settings.

Match pattern: ^[a-fA-F0-9]{24}$

admPolicyAssignments array [object] optional

Array of policy assignments with priority ordering for devices enrolled under this enrollment rule.

admPolicyId string optional

Policy identifier for multi-policy assignment specifying device configuration and security requirements.

Match pattern: ^[a-fA-F0-9]{24}$

admPolicy object optional

Complete policy configuration object embedded for reference containing device restrictions and settings.

priority integer optional

Numeric priority value determining policy application order when multiple policies target same device.

≥ 0

commands array [object] optional

Array of MDM commands automatically executed on devices during enrollment rule application process.

admVppLocationId string optional

Volume Purchase Program location identifier for automatic app assignment during device enrollment.

Match pattern: ^[a-fA-F0-9]{24}$

admVppLocationInfo object optional

Volume Purchase Program location metadata containing app distribution and purchasing configuration details.

id string optional

Volume Purchase Program location unique identifier within Apple Business Manager organization.

Match pattern: ^[a-fA-F0-9]{24}$

name string optional

Human-readable VPP location name identifying app purchase and distribution settings.

≤ 256 characters

config object optional

VPP location configuration settings defining regional app purchasing and distribution parameters.

allowActivationLock boolean optional

Flag permitting iOS Activation Lock feature enabling device theft protection during enrollment.

setupAssistantEnable boolean optional

Flag enabling Setup Assistant presentation during device enrollment for user configuration guidance.

setupAssistantSkippable boolean optional

Flag allowing users to skip Setup Assistant steps during enrollment for faster device activation.

skipPersonalInfo boolean optional

Flag bypassing personal information collection in Setup Assistant during corporate device enrollment.

segmentId integer optional

Optional segment identifier for targeting enrollment device to a specific segment.

≥ 0

auxiliaryFields array [object] optional

Array of custom input fields collected from users during enrollment for conditional policy application.

type string optional

Input field type determining validation and presentation format for custom user data collection.

select text

key string required

Unique field identifier key used for storing and referencing custom user data in enrollment workflow.

≤ 128 characters

title string optional

Human-readable field label displayed to users during enrollment data collection process.

≤ 128 characters

description string optional

Explanatory field description providing guidance to users during custom data input.

≤ 256 characters

options array [string] optional

Array of selectable values presented to users when auxiliary field type is select.

loginProviderTypes array [string] optional

Array of authentication provider types permitted for user verification during device enrollment workflow.

allowAutoContinue boolean optional

Flag enabling automatic progression through enrollment steps without requiring user interaction at each stage.

version string optional

Sequential version string tracking enrollment template configuration changes and synchronization state.

≤ 128 characters

updatedAt string optional

Timestamp indicating when enrollment template configuration was last modified or synchronized.

Format: date-time

createdAt string optional

Timestamp indicating when enrollment template configuration was initially created in system.

Format: date-time

devicesCount integer optional

Total number of Apple devices currently enrolled and managed using this enrollment template.

≥ 0

segmentId integer optional

Segment identifier for scoping smart enrollment into an specific segment

≥ 0

totalDocs integer optional

limit integer optional

hasPrevPage boolean optional

hasNextPage boolean optional

page integer optional

totalPages integer optional

prevPage integer optional

nextPage integer optional

lean boolean optional

{
    "status": true,
    "data": {
        "items": [
            {
                "id": "698f2b1c18f11470ce02da32",
                "name": "Sales Team iPad Enrollment",
                "description": "Standard configuration for sales team iPads with productivity apps and security policies.",
                "rules": [
                    {
                        "name": "Executive Device Setup",
                        "displayNamePattern": "{firstName}-{lastName}-iPad",
                        "setDeviceName": true,
                        "tags": [
                            "executive",
                            "high-security"
                        ],
                        "conditions": [
                            {
                                "tags": [
                                    [
                                        "executive"
                                    ],
                                    [
                                        "manager",
                                        "director"
                                    ]
                                ],
                                "auxiliaryFields": [
                                    [
                                        "department:sales"
                                    ],
                                    [
                                        "location:hq"
                                    ]
                                ],
                                "patterns": [
                                    "^iPad.*",
                                    ".*Proquot;
                                ],
                                "identifiers": [
                                    "[email protected]",
                                    "A1B2C3D4E5F6"
                                ]
                            }
                        ],
                        "admPolicyId": "698f2b1c18f11470ce02da32",
                        "admPolicyAssignments": [
                            {
                                "admPolicyId": "698f2b1c18f11470ce02da32",
                                "admPolicy": {},
                                "priority": 10
                            }
                        ],
                        "commands": [
                            {
                                "type": "InstallProfile",
                                "profileId": "698f2b1c18f11470ce02da32"
                            }
                        ],
                        "admVppLocationId": "698f2b1c18f11470ce02da32",
                        "admVppLocationInfo": {
                            "id": "698f2b1c18f11470ce02da32",
                            "name": "US Corporate VPP",
                            "config": {
                                "countryISO2ACode": "US",
                                "defaultPlatform": "ios",
                                "locationName": "US Corporate Location"
                            }
                        },
                        "allowActivationLock": false,
                        "setupAssistantEnable": true,
                        "setupAssistantSkippable": false,
                        "skipPersonalInfo": true,
                        "segmentId": 1
                    }
                ],
                "auxiliaryFields": [
                    {
                        "type": "select",
                        "key": "department",
                        "title": "Department",
                        "description": "Select your organizational department for policy assignment.",
                        "options": [
                            "Sales",
                            "Engineering",
                            "Marketing",
                            "Operations"
                        ]
                    }
                ],
                "loginProviderTypes": [
                    "ldap",
                    "saml",
                    "google"
                ],
                "allowAutoContinue": true,
                "version": "3.2.1",
                "updatedAt": "2026-02-10T14: 22:00Z",
                "createdAt": "2026-01-15T10: 30:00Z",
                "devicesCount": 45,
                "segmentId": 1
            }
        ],
        "totalDocs": 0,
        "limit": 0,
        "hasPrevPage": true,
        "hasNextPage": true,
        "page": 0,
        "totalPages": 0,
        "prevPage": 0,
        "nextPage": 0,
        "lean": true
    }
}

401 Response application/json

status boolean optional

false

error object optional

code number optional

4004

message string optional

Invalid Token

{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}

404 Response application/json

status boolean optional

false

error object optional

code number optional

3001

message string optional

Entity not found

{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}