Before you start
- An Iru API token with MCP turned on and permissions that cover the calls below (recipe 1).
- An ADE token connected to Iru, with devices assigned to Iru in Apple Business or Apple School Manager (Configure Automated Device Enrollment).
Prompt for your agent
List my ADE devices in Iru with GET /api/v1/integrations/apple/ade/devices, and page through every result. Keep the devices where mdm_device is null. For each one, show me its serial_number, model, the dep_account server_name, profile_status and device_assigned_date. For the devices that do have an mdm_device record, show me enrollment_status as the API returns it, without interpreting the number. Tell me how many devices fall in each group.
Steps
List the ADE devices
Each result is one device that Apple Business or Apple School Manager assigned to Iru. Results are paginated, so have the agent page through all of them.
To narrow the list, the call takes
dep_account(the ADE token ID),profile_status(assigned, empty, pushed or removed),device_family,os,modelandserial_number.GET/api/v1/integrations/apple/ade/devicesSource: Iru API: List ADE devices
Keep the devices with no enrolled record
When
mdm_deviceisnull, the device has no enrolled record in Iru. Iru lists these devices in an Awaiting Enrollment status.For devices that do have an
mdm_devicerecord, the response includesenrollment_status. The docs don't define its numeric values, so have the agent show you the number and don't treat it as a label.Read the assignment details
Use
profile_status,profile_assign_time,profile_push_time,last_assignment_statusandfailed_assignment_attemptsto see how far each device got. Ask the agent to list the devices that still have nomdm_devicerecord, oldest assignment first.Source: Iru API: List ADE devices
Check each device's Blueprint setup
With Blueprint Routing on,
use_blueprint_routingis true andblueprint_idis null. A device can also carry an ADE Library Item override inoverride_dep_profile_id.Source: Iru API: List ADE devices
Check it worked
- Every serial number on the list has
mdm_deviceset tonull.
Common pitfalls
- A device that sits in Awaiting Enrollment checks with Apple for its configuration only after someone powers it on and connects it to a network.
- Once Iru assigns a device to Blueprint Routing for enrollment, it always re-enrolls through Blueprint Routing unless you set it otherwise.
- If an ADE token expires, Iru can no longer sync devices from Apple Business or Apple School Manager, so new assignments never show up here.
FAQ
Which API call lists ADE devices?
GET /api/v1/integrations/apple/ade/devices lists them. You can filter by dep_account, profile_status, device_family, os, model and serial_number.
How do I tell a device has not enrolled?
A device with mdm_device set to null has no enrolled record, and Iru shows it as Awaiting Enrollment.
What are the values of profile_status?
The filter accepts assigned, empty, pushed and removed.
Why does a Blueprint Routing device show a null blueprint_id?
Once Iru assigns a device to Blueprint Routing for enrollment, use_blueprint_routing is true and blueprint_id stays null.