Skip to content
All recipes

Find ADE devices that were never enrolled

List the Automated Device Enrollment (ADE) devices assigned to Iru that have no enrolled device record yet.

Open in Claude Open in ChatGPT
Product
Endpoint Management
Platforms
Apple devices
Effect
Read-only
Agent access
Iru MCP or the Iru API

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

  1. 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, model and serial_number.

    GET/api/v1/integrations/apple/ade/devices

    Source: Iru API: List ADE devices

  2. Keep the devices with no enrolled record

    When mdm_device is null, the device has no enrolled record in Iru. Iru lists these devices in an Awaiting Enrollment status.

    For devices that do have an mdm_device record, the response includes enrollment_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.

    Source: Configure Automated Device Enrollment

  3. Read the assignment details

    Use profile_status, profile_assign_time, profile_push_time, last_assignment_status and failed_assignment_attempts to see how far each device got. Ask the agent to list the devices that still have no mdm_device record, oldest assignment first.

    Source: Iru API: List ADE devices

  4. Check each device's Blueprint setup

    With Blueprint Routing on, use_blueprint_routing is true and blueprint_id is null. A device can also carry an ADE Library Item override in override_dep_profile_id.

    Source: Iru API: List ADE devices

Check it worked

  • Every serial number on the list has mdm_device set to null.

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.

Next steps

Sources

Stay up to date

Iru's bi-weekly collection of articles, videos, and research to keep IT & Security teams ahead of the curve.