Overview
This workflow queries one AirDroid Business device by IMEI and returns its current Policy & Kiosk effective status through an API response. It is a reusable step for operations that need a consistent status lookup for deployment checks or external integrations.
The Problem This Workflow Solves
Teams that manage AirDroid Business devices sometimes need to confirm whether a single device has the expected Policy & Kiosk configuration. The lookup must be done by IMEI, and the result must show whether the device was found, whether the IMEI is unique, and what status should be returned to the calling system.
- Direct status check. The workflow returns the device's current Policy & Kiosk status in one response.
- Clear lookup result. It separates missing, ambiguous, and successful matches for easier follow-up.
- API-friendly output. External systems receive a consistent status code, message, and status value.
Who This Is For
- Operations teams. They use this query when they need a current status check for one managed device.
- Integration owners. They call the API from external systems that need Policy & Kiosk status by IMEI.
- Deployment verification users. They confirm whether a single device reports the expected configuration effective status.
What Sets This Workflow Apart
- Single-device scope. The workflow accepts one IMEI and does not support batch, group, or device name queries.
- Unique-match check. It confirms that the IMEI matches exactly one device before returning the status.
- Unified response. It returns success and failure results in a consistent format for calling systems.
How It Works
- Check the IMEI
- The workflow first checks that an IMEI is provided. If it is missing, the workflow ends with an invalid input response.
- Build query context and locate the device
- The workflow records the query time, searches AirDroid Business by IMEI, and reads the device snapshot if the lookup succeeds.
- Validate the match and return the response
- The workflow confirms the device lookup, checks that exactly one device matched, and returns the Policy & Kiosk effective status or a failure message.
What You'll Need
- AirDroid Business credentials
- An authorized connection is needed so the workflow can search devices by IMEI and read configuration status.
- Target device IMEI
- The calling system must provide one required IMEI value for the device you want to query.
How to Use
- Step 1. Connect credentials
- Step 2. Pass the device IMEI
- Step 3. Read the returned fields
Bind authorized AirDroid Business credentials so the workflow can search for the device and return its status.
Send the target device IMEI from your external system to start the query.
Check Success, StatusCode, and PolicyKioskEffectiveStatus when the query succeeds, or ErrorMessage when it fails.