Skip to main content

Device State Mapping

Esper describes a device's lifecycle with a set of device states. The API and the console use the same underlying states, but they don't always display them the same way. Depending on where you look in the console, a state may appear under its exact API name, under a friendlier label, or grouped into a broader category.

This document maps each API state to how it appears in the console, for iOS, Linux, Windows, and Android devices. It covers places in the console where states show up:

  • Device State column: Shows the exact API state name.
  • Device State filter dropdown: Uses simplified labels and groups several states under Others.
  • Dashboard > Device Status panel: Groups every state except ACTIVE as Unprovisioned.
  • Reports: Device reports list the full set of granular states, such as GOOGLE_PLAY_CONFIGURATION or BRANDING_PROCESSED.

State Mapping for iOS, Linux, and Windows

API StatesConsole States
Device State ColumnDevice State Filter Dropdown
REGISTEREDREGISTEREDRegistered
ONBOARDING_IN_PROGRESSONBOARDING_IN_PROGRESSOnboarding In Progress
ONBOARDEDONBOARDEDOnboarded
ACTIVEACTIVEProvisioned
WIPE_IN_PROGRESSWIPE_IN_PROGRESSOthers

State Mapping for Android Devices

API StatesConsole States
Device State ColumnDevice State Filter Dropdown
REGISTEREDREGISTEREDRegistered
PROVISIONING_BEGINPROVISIONING_BEGINOthers
GOOGLE_PLAY_CONFIGURATIONGOOGLE_PLAY_CONFIGURATION
POLICY_APPLICATION_IN_PROGRESSPOLICY_APPLICATION_IN_PROGRESS
ONBOARDING_IN_PROGRESSONBOARDING_IN_PROGRESS
AFW_ACCOUNT_ADDEDAFW_ACCOUNT_ADDED
APPS_INSTALLEDAPPS_INSTALLED
BRANDING_PROCESSEDBRANDING_PROCESSED
PERMISSION_POLICY_PROCESSEDPERMISSION_POLICY_PROCESSED
DEVICE_POLICY_PROCESSEDDEVICE_POLICY_PROCESSED
DEVICE_SETTINGS_PROCESSEDDEVICE_SETTINGS_PROCESSED
SECURITY_POLICY_PROCESSEDSECURITY_POLICY_PROCESSED
PHONE_POLICY_PROCESSEDPHONE_POLICY_PROCESSED
CUSTO_SETTINGS_PROCESSEDCUSTO_SETTINGS_PROCESSED
WIPE_IN_PROGRESSWIPE_IN_PROGRESS
ONBOARDING_IN_PROGRESSONBOARDING_IN_PROGRESSOnboarding In Progress
ONBOARDEDONBOARDEDOnboarded
ACTIVEACTIVEProvisioned
Tip: The Dashboard > Device Status panel also maps device states. All states except ACTIVE appear as Unprovisioned.

Best Practices

The API and the Device State column use the same state names, so they're the most reliable reference when you need precision. The filter dropdown and the Dashboard summarize those states for quick scanning, which means some detail drops out. In general, rely on API state names when you're writing integrations, pulling reports, or troubleshooting a specific device. Use the console labels when you're describing a fleet at a high level.

If you find a state that isn't covered here, or a console label that doesn't match this mapping, let the Customer Education team know so we can keep this document and the API documentation in sync.

Featured content