Favicon

You are here: Home > API Reference > UEM > Mdm Devices > Retrieve unified cross-platform device list

Retrieve unified cross-platform device list

Required Permission: mdm.global.device.list

Retrieves paginated list of all managed endpoints across Android, iOS, macOS, and Windows with extensive filtering, compliance tracking, and policy assignment visibility for comprehensive fleet management.

GET
/v1/organizations/:organizationId/mdm/devices/
Copy to clipboard

Retrieve unified cross-platform device list

Required Permission: mdm.global.device.list

Retrieves paginated list of all managed endpoints across Android, iOS, macOS, and Windows with extensive filtering, compliance tracking, and policy assignment visibility for comprehensive fleet management.

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 controls starting at one enabling navigation through large devices collections efficiently.
limit integer
optional
Maximum number of devices returned per page controlling result set size for pagination and performance optimization.
sort string
optional
Sort field and direction for ordering device list results enabling customized data presentation and filtering.
Match pattern: ^[\w.]*((:asc)|(:desc))?$
mdmUserId string
optional
Filter parameter for MDM user identifier to retrieve devices assigned to specific user.
Match pattern: ^[a-fA-F0-9]{24}$
type string
optional
Device platform type indicating Android iOS Apple ecosystem or Windows for platform-specific management operations.
androidapplewindows
subType string
optional
Device enrollment classification distinguishing fully enrolled devices from pending enrollment tokens for status tracking.
deviceenrollment
showAll boolean
optional
Filter flag to include deactivated or archived devices in results bypassing default active-only filter.
policyId string
optional
Filter parameter for policy identifier to retrieve devices with specific policy assignment.
Match pattern: ^[a-fA-F0-9]{24}$
imei string
optional
Filter parameter for device IMEI number enabling hardware-specific device lookups.
≤ 256 characters
serialNumber string
optional
Filter parameter for device serial number for manufacturer-specific device identification.
≤ 256 characters
state string
optional
Current device lifecycle state reflecting enrollment status, provisioning progress, or deactivation for management workflows.
≤ 256 characters
onlyAdmDep boolean
optional
Filter flag to retrieve only Apple DEP-enrolled devices for corporate-owned device reporting.
name string
optional
Filter parameter for device display name enabling partial name matching in search queries.
≤ 256 characters
isCompliance boolean
optional
Filter flag to retrieve only compliant or non-compliant devices for security auditing workflows.
lastSyncError boolean
optional
Filter flag to retrieve devices with recent synchronization errors for troubleshooting purposes.
emmEnrollmentTemplateId string
optional
Filter parameter for Android enrollment template identifier to group devices by enrollment method.
Match pattern: ^[a-fA-F0-9]{24}$
admEnrollmentTemplateId string
optional
Filter parameter for Apple enrollment template identifier to segment devices by enrollment workflow.
Match pattern: ^[a-fA-F0-9]{24}$
winEnrollmentTemplateId string
optional
Filter parameter for Windows enrollment template identifier for enrollment method-based device grouping.
Match pattern: ^[a-fA-F0-9]{24}$
tags array
optional
Array of organizational tags for grouping devices by department, location, or custom criteria in filtering workflows.
search string
optional
Full-text search parameter matching device names, serial numbers, IMEIs, or user emails for flexible discovery.
≤ 256 characters
osVersion string
optional
Filter parameter for operating system version enabling version-specific device targeting for updates.
≤ 128 characters
availableUpdate string
optional
Filter parameter for pending OS update version identifying devices eligible for upgrade campaigns.
≤ 128 characters
networkIp string
optional
Filter parameter for device network IP address enabling network-based device discovery and segmentation.
≤ 128 characters
segmentId integer
optional
Segment identifier for scoping devices into an specific segment
expandTo string
optional
Param to include ancestor or child related entities
ancestorschildren
deviceAudiences array
optional

Responses

200 Response application/json
status boolean optional
data object optional
items array [object] optional
id string optional
Managed device unique identifier used for API operations, policy assignments, and tracking device lifecycle across platforms.
Match pattern: ^[a-fA-F0-9]{24}$
type string optional
Device platform type indicating Android iOS Apple ecosystem or Windows for platform-specific management operations.
android apple windows
subType string optional
Device enrollment classification distinguishing fully enrolled devices from pending enrollment tokens for status tracking.
device enrollment
state string optional
Current device lifecycle state reflecting enrollment status, provisioning progress, or deactivation for management workflows.
≤ 128 characters
organization string optional
Organization identifier linking managed device to workspace for access control and resource isolation purposes.
Match pattern: ^[a-fA-F0-9]{24}$
organizationInfo object optional
Organization details object containing workspace name, slug, and branding information for dashboard display.
id string optional
Match pattern: ^[a-fA-F0-9]{24}$
name string optional
≤ 128 characters
slug string optional
≤ 128 characters · ≥ 3 characters · Match pattern: ^[a-zA-Z0-9][a-zA-Z0-9-]+[a-zA-Z0-9]$
store object optional
customDomain string optional
≤ 256 characters
branding object optional
logo string optional
≤ 256 characters
picture string optional
primaryColor string optional
Match pattern: ^#[a-zA-Z0-9]{6}$
configuration object optional
storageProvider string optional
Match pattern: ^[a-fA-F0-9]{24}$
createdBy string optional
Match pattern: ^[a-fA-F0-9]{24}$
sortDate string optional
Timestamp used for chronological sorting in device lists, typically reflecting enrollment or last activity date.
Format: date-time
enrolledDate string optional
Device enrollment completion timestamp marking successful MDM profile installation or enrollment token acceptance.
Format: date-time
mdmUser object optional
Assigned MDM user object containing identifier and email for device ownership and communication tracking.
id string optional
MDM user unique identifier linking device to user account for personalization and access policies.
Match pattern: ^[a-fA-F0-9]{24}$
email string optional
MDM user email address used for notifications, password resets, and user-targeting communications.
≤ 256 characters · Format: email
displayName string optional
Device custom display name set by administrator or user for easier identification in device listings.
≤ 128 characters
tags array [string] optional
Array of organizational tags for grouping devices by department, location, or custom criteria in filtering workflows.
emmEnterprise string optional
Android Enterprise (EMM) enterprise identifier linking device to Google workspace for managed play store access.
Match pattern: ^[a-fA-F0-9]{24}$
admEnterprise string optional
Apple Device Management enterprise identifier for DEP enrollment and VPP app assignment coordination.
Match pattern: ^[a-fA-F0-9]{24}$
emmDevice string optional
Android Enterprise device identifier from Google API for direct device operations and policy synchronization.
Match pattern: ^[a-fA-F0-9]{24}$
lastStatusReportTime string optional
Timestamp of most recent device status report indicating last successful communication with MDM server.
Format: date-time
summary object optional
Hardware and software summary object aggregating device name, OS version, IMEI, battery status, and compliance state.
name string optional
≤ 256 characters
osVersion string optional
≤ 128 characters
managementMode string optional
DEVICE_OWNER PROFILE_OWNER COPE USERLESS
imei string optional
≤ 128 characters
battery string optional
≤ 128 characters
expirationTimestamp string optional
Format: date-time
os string optional
≤ 128 characters
serialNumber string optional
≤ 128 characters
supervised boolean optional
compliance object optional
image string optional
≤ 500 characters
manufacturer string optional
≤ 128 characters
model string optional
≤ 128 characters
udid string optional
≤ 128 characters
hostname string optional
≤ 128 characters
ipAddress string optional
≤ 128 characters
macAddress string optional
≤ 128 characters
emmPolicy object optional
Currently assigned Android Enterprise policy defining device restrictions, app deployments, and security configuration.
id string optional
EMM policy unique identifier for API operations and policy change tracking.
≤ 128 characters
name string optional
EMM policy display name for administrative identification in dashboard interfaces.
≤ 256 characters
version string optional
EMM policy version number synchronized with Google Android Enterprise policy revisions.
≤ 128 characters
admPolicy object optional
Currently assigned Apple Device Management policy controlling iOS macOS device settings and application deployment.
id string optional
ADM policy unique identifier for API operations and profile version tracking.
≤ 128 characters
name string optional
ADM policy display name shown in device profile management interfaces.
≤ 256 characters
version string optional
ADM policy version number for tracking configuration profile updates.
≤ 128 characters
appliedEmmPolicy object optional
Android policy version currently enforced on device, may differ from assigned policy during transition periods.
id string optional
≤ 128 characters
name string optional
≤ 256 characters
version string optional
≤ 128 characters
admPolicyAssignments array [object] optional
Prioritized list of Apple policies assigned to device for composition and conflict resolution strategies.
admPolicyId string optional
Apple policy unique identifier for assignment tracking and API operations in policy composition workflows.
Match pattern: ^[a-fA-F0-9]{24}$
admPolicy object optional
Complete Apple Device Management policy object containing configuration profiles, restrictions, and app deployment settings.
id string optional
Unique Apple device policy identifier used to track configuration rules and security settings throughout lifecycle.
Match pattern: ^[a-fA-F0-9]{24}$
organization string optional
Organization identifier owning this Apple device policy and managing enrolled iOS iPadOS and macOS devices.
Match pattern: ^[a-fA-F0-9]{24}$
admEnterprise string optional
Apple enterprise account identifier linked to Apple Business Manager or Apple School Manager for device management.
Match pattern: ^[a-fA-F0-9]{24}$
targetType string optional
Policy application scope defining whether configurations apply to entire device or device user context only.
device deviceUser
attachedProfile object optional
Automatically attached configuration profile containing essential MDM settings applied independently of policy assignments and priorities.
name string optional
Human-readable policy name displayed in dashboard for administrative identification and organizational purposes throughout device management.
≤ 256 characters
profiles array [object] optional
List of Apple configuration profiles containing device restrictions security settings and feature configurations applied by policy.
applications array [object] optional
List of application assignments defining managed apps with VPP licensing installation actions and configuration settings.
applicationsInfo array [object] optional
Enriched application metadata including app names icons versions and store information for dashboard display purposes.
books array [object] optional
List of book assignments for distributing VPP-purchased books or PDF documents to managed Apple devices.
booksInfo array [object] optional
Enriched book metadata including titles authors cover images and store information for dashboard display purposes.
scripts array [object] optional
List of script assignments for executing automated tasks compliance checks and configuration enforcement on macOS devices.
scriptsInfo array [object] optional
Enriched script metadata including execution history last run timestamps and success rates for monitoring purposes.
bookmarks array [object] optional
List of bookmark assignments for deploying web application shortcuts and internal portal links to device home screens.
assets array [object] optional
List of asset assignments for deploying files certificates configuration data and resources to managed macOS devices.
assetsInfo array [object] optional
Enriched asset metadata including file sizes deployment status and version information for monitoring and auditing purposes.
version integer optional
Policy version number incremented with each modification for tracking configuration changes and rollback capabilities.
≥ 0
updatedAt string optional
ISO timestamp of last policy modification for change tracking synchronization and audit trail purposes.
Format: date-time
createdAt string optional
ISO timestamp when policy was created in system for lifecycle tracking and compliance reporting purposes.
Format: date-time
agentConfiguration object optional
MDM agent behavior settings controlling location tracking app monitoring data collection and application enforcement actions.
segmentId integer optional
Segment identifier for scoping policy into an specific segment
≥ 0
priority integer optional
Policy assignment priority determining precedence when multiple policies apply to device for conflict resolution.
≥ 0
admPolicyAssignmentsEnforced array [object] optional
Apple policy assignments with automation rule attribution showing which rules triggered each assignment.
admPolicyId string optional
Apple policy unique identifier for assignment tracking and API operations in policy composition workflows.
Match pattern: ^[a-fA-F0-9]{24}$
admPolicy object optional
Complete Apple Device Management policy object containing configuration profiles, restrictions, and app deployment settings.
id string optional
Unique Apple device policy identifier used to track configuration rules and security settings throughout lifecycle.
Match pattern: ^[a-fA-F0-9]{24}$
organization string optional
Organization identifier owning this Apple device policy and managing enrolled iOS iPadOS and macOS devices.
Match pattern: ^[a-fA-F0-9]{24}$
admEnterprise string optional
Apple enterprise account identifier linked to Apple Business Manager or Apple School Manager for device management.
Match pattern: ^[a-fA-F0-9]{24}$
targetType string optional
Policy application scope defining whether configurations apply to entire device or device user context only.
device deviceUser
attachedProfile object optional
Automatically attached configuration profile containing essential MDM settings applied independently of policy assignments and priorities.
name string optional
Human-readable policy name displayed in dashboard for administrative identification and organizational purposes throughout device management.
≤ 256 characters
profiles array [object] optional
List of Apple configuration profiles containing device restrictions security settings and feature configurations applied by policy.
applications array [object] optional
List of application assignments defining managed apps with VPP licensing installation actions and configuration settings.
applicationsInfo array [object] optional
Enriched application metadata including app names icons versions and store information for dashboard display purposes.
books array [object] optional
List of book assignments for distributing VPP-purchased books or PDF documents to managed Apple devices.
booksInfo array [object] optional
Enriched book metadata including titles authors cover images and store information for dashboard display purposes.
scripts array [object] optional
List of script assignments for executing automated tasks compliance checks and configuration enforcement on macOS devices.
scriptsInfo array [object] optional
Enriched script metadata including execution history last run timestamps and success rates for monitoring purposes.
bookmarks array [object] optional
List of bookmark assignments for deploying web application shortcuts and internal portal links to device home screens.
assets array [object] optional
List of asset assignments for deploying files certificates configuration data and resources to managed macOS devices.
assetsInfo array [object] optional
Enriched asset metadata including file sizes deployment status and version information for monitoring and auditing purposes.
version integer optional
Policy version number incremented with each modification for tracking configuration changes and rollback capabilities.
≥ 0
updatedAt string optional
ISO timestamp of last policy modification for change tracking synchronization and audit trail purposes.
Format: date-time
createdAt string optional
ISO timestamp when policy was created in system for lifecycle tracking and compliance reporting purposes.
Format: date-time
agentConfiguration object optional
MDM agent behavior settings controlling location tracking app monitoring data collection and application enforcement actions.
segmentId integer optional
Segment identifier for scoping policy into an specific segment
≥ 0
priority integer optional
Policy assignment priority determining precedence when multiple policies apply to device for conflict resolution.
≥ 0
automationRule object optional
Automation rule object documenting which rule triggered policy assignment for audit trails and compliance reports.
id string optional
Match pattern: ^[a-fA-F0-9]{24}$
name string optional
≤ 256 characters
deviceAudiences array [object] optional
lastLocation object optional
Most recent device geolocation coordinates captured during location tracking or lost mode activation.
agent object optional
origin string optional
agent ip
date string optional
Format: date-time
latitude number optional
Format: float · ≥ -90 · ≤ 90
longitude number optional
Format: float · ≥ -180 · ≤ 180
ip string optional
≤ 128 characters
lastReportDate string optional
Format: date-time
address object optional
ip object optional
origin string optional
agent ip
date string optional
Format: date-time
latitude number optional
Format: float · ≥ -90 · ≤ 90
longitude number optional
Format: float · ≥ -180 · ≤ 180
ip string optional
≤ 128 characters
lastReportDate string optional
Format: date-time
address object optional
admVppLocation string optional
Apple VPP location identifier for volume purchase program app assignments and license management.
Match pattern: ^[a-fA-F0-9]{24}$
lostMode object optional
Lost mode configuration object tracking activation status, timestamps, and last known location coordinates.
enabled boolean optional
Lost mode activation flag indicating whether device is currently in restricted lost mode state.
startDate string optional
Lost mode activation timestamp marking when administrator enabled lost mode restrictions.
Format: date-time
endDate string optional
Lost mode deactivation timestamp indicating when device was recovered or lost mode disabled.
Format: date-time
stoppedBy string optional
Entity that deactivated lost mode, either user, admin, or system for audit trail purposes.
admin user
lastLocation object optional
Geo coordinates and battery level captured at time of last location ping during lost mode.
latitude integer optional
Latitude coordinate of device location for mapping and recovery operations.
≥ 0
longitude integer optional
Longitude coordinate of device location for mapping and recovery operations.
≥ 0
batteryLevel integer optional
Device battery percentage at time of location capture for recovery planning.
≥ 0
emmPolicyAssignments array [object] optional
Prioritized list of Android Enterprise policies assigned for device configuration composition.
emmPolicyId string optional
Android Enterprise policy unique identifier for assignment tracking and composition operations.
Match pattern: ^[a-fA-F0-9]{24}$
emmPolicy object optional
Complete Android Enterprise policy object with device restrictions, application deployments, and security configurations.
id string optional
Unique Android Enterprise policy identifier used to track configuration rules and security settings throughout lifecycle.
Match pattern: ^[a-fA-F0-9]{24}$
name string optional
Human-readable policy name displayed in dashboard for administrative identification and organizational purposes throughout device management.
≤ 128 characters
description string optional
Detailed policy description explaining configuration purpose business requirements and device restrictions for documentation purposes.
≤ 256 characters
version string optional
Policy version identifier synchronized with Google Android Enterprise policy version for change tracking purposes.
≤ 128 characters
config object optional
Google Android Enterprise policy configuration object containing device restrictions security settings and compliance rules.
_config object optional
Internal configuration data restricted to administrator access level containing sensitive policy credentials and system metadata.
packages object optional
Application package information mapping containing installed app details versions and configuration for reporting purposes.
emmEnterprise string optional
Android Enterprise (EMM) account identifier linked to Google Managed Play for device and application management.
Match pattern: ^[a-fA-F0-9]{24}$
private boolean optional
Flag indicating whether policy is private to organization or shared across enterprise for template purposes.
assets array [object] optional
List of asset assignments for deploying files certificates configuration data and resources to managed Android devices.
assetsInfo array [object] optional
Enriched asset metadata including file sizes deployment status and version information for monitoring and auditing purposes.
updatedAt string optional
ISO timestamp of last policy modification for change tracking synchronization and audit trail purposes.
Format: date-time
createdAt string optional
ISO timestamp when policy was created in system for lifecycle tracking and compliance reporting purposes.
Format: date-time
agentConfiguration object optional
MDM agent behavior settings controlling location tracking application monitoring and network status reporting on Android devices.
kioskLauncherConfiguration object optional
Kiosk launcher customization settings defining home screen layout lock screen behavior and application restrictions for dedicated devices.
certificateProviderIds array [string] optional
List of certificate provider identifiers for deploying PKI credentials and authentication certificates to Android devices.
applications array [object] optional
List of application assignments defining managed apps with installation actions configuration and update policies for deployment.
applicationsInfo array [object] optional
Enriched application metadata including app details names icons versions for dashboard display and reporting purposes.
segmentId integer optional
Segment identifier for scoping policy into an specific segment
≥ 0
priority integer optional
Policy assignment priority determining precedence when multiple policies apply to device for conflict resolution.
≥ 0
emmPolicyAssignmentsEnforced array [object] optional
Android policy assignments with automation rule details documenting assignment triggers and device audience matching.
emmPolicyId string optional
Android Enterprise policy unique identifier for assignment tracking and composition operations.
Match pattern: ^[a-fA-F0-9]{24}$
emmPolicy object optional
Complete Android Enterprise policy object with device restrictions, application deployments, and security configurations.
id string optional
Unique Android Enterprise policy identifier used to track configuration rules and security settings throughout lifecycle.
Match pattern: ^[a-fA-F0-9]{24}$
name string optional
Human-readable policy name displayed in dashboard for administrative identification and organizational purposes throughout device management.
≤ 128 characters
description string optional
Detailed policy description explaining configuration purpose business requirements and device restrictions for documentation purposes.
≤ 256 characters
version string optional
Policy version identifier synchronized with Google Android Enterprise policy version for change tracking purposes.
≤ 128 characters
config object optional
Google Android Enterprise policy configuration object containing device restrictions security settings and compliance rules.
_config object optional
Internal configuration data restricted to administrator access level containing sensitive policy credentials and system metadata.
packages object optional
Application package information mapping containing installed app details versions and configuration for reporting purposes.
emmEnterprise string optional
Android Enterprise (EMM) account identifier linked to Google Managed Play for device and application management.
Match pattern: ^[a-fA-F0-9]{24}$
private boolean optional
Flag indicating whether policy is private to organization or shared across enterprise for template purposes.
assets array [object] optional
List of asset assignments for deploying files certificates configuration data and resources to managed Android devices.
assetsInfo array [object] optional
Enriched asset metadata including file sizes deployment status and version information for monitoring and auditing purposes.
updatedAt string optional
ISO timestamp of last policy modification for change tracking synchronization and audit trail purposes.
Format: date-time
createdAt string optional
ISO timestamp when policy was created in system for lifecycle tracking and compliance reporting purposes.
Format: date-time
agentConfiguration object optional
MDM agent behavior settings controlling location tracking application monitoring and network status reporting on Android devices.
kioskLauncherConfiguration object optional
Kiosk launcher customization settings defining home screen layout lock screen behavior and application restrictions for dedicated devices.
certificateProviderIds array [string] optional
List of certificate provider identifiers for deploying PKI credentials and authentication certificates to Android devices.
applications array [object] optional
List of application assignments defining managed apps with installation actions configuration and update policies for deployment.
applicationsInfo array [object] optional
Enriched application metadata including app details names icons versions for dashboard display and reporting purposes.
segmentId integer optional
Segment identifier for scoping policy into an specific segment
≥ 0
priority integer optional
Policy assignment priority determining precedence when multiple policies apply to device for conflict resolution.
≥ 0
automationRule object optional
Automation rule object documenting which rule triggered policy assignment for audit trails and compliance reports.
id string optional
Match pattern: ^[a-fA-F0-9]{24}$
name string optional
≤ 256 characters
deviceAudiences array [object] optional
winPolicy object optional
Currently assigned Windows MDM policy controlling device restrictions and application deployments for Windows endpoints.
id string optional
Windows MDM policy unique identifier for API operations and policy tracking.
Match pattern: ^[a-fA-F0-9]{24}$
name string optional
Windows MDM policy display name for administrative identification.
≤ 256 characters
version string optional
Windows MDM policy version number for configuration change tracking.
≤ 128 characters
winPolicyAssignments array [object] optional
Prioritized list of Windows policies assigned to device for configuration composition workflows.
winPolicyId string optional
Windows MDM policy unique identifier for assignment tracking and policy composition workflows.
Match pattern: ^[a-fA-F0-9]{24}$
winPolicy object optional
Complete Windows MDM policy object with device security restrictions and application deployment configurations.
id string optional
Unique identifier for this specific resource instance in the system following a standardized format enabling targeted operations, relationship mapping, and tracking across all platform endpoints and data stores.
Match pattern: ^[a-fA-F0-9]{24}$
organizationId string optional
Organization identifier indicating workspace ownership for access control and data isolation across multi-tenant environments.
Match pattern: ^[a-fA-F0-9]{24}$
winEnterpriseId string optional
Windows enterprise configuration identifier linking policy to specific enrollment settings and device management context.
Match pattern: ^[a-fA-F0-9]{24}$
name string optional
Policy display name shown in interfaces and used for identification in listings and device assignments.
≤ 256 characters
config object optional
OMA-DM configuration object containing registry settings, security policies, and device restrictions to apply on managed Windows devices.
applications array [object] optional
Array of application assignments included in policy enabling bundled deployment and management of software packages.
applicationsInfo array [object] optional
Application metadata array containing name, version, and publisher details for included apps displayed in interfaces.
bookmarks array [object] optional
scripts array [object] optional
Array of script assignments included in policy enabling automated PowerShell or batch command operations.
scriptsInfo array [object] optional
Script metadata array containing name, description, and timing details for included scripts providing comprehensive script information in interfaces.
admxConfigs array [object] optional
Array of ADMX configuration assignments enabling group policy template settings for advanced Windows configurations.
admxConfigsInfo array [object] optional
ADMX configuration metadata array containing template details, settings types, and descriptions.
agentConfiguration object optional
MDM agent configuration settings controlling agent deployment, permissions, and capabilities on managed devices.
assets array [object] optional
Array of file asset assignments included in policy enabling deployment of certificates, configuration files, or resources.
assetsInfo array [object] optional
Asset metadata array containing file names, types, and sizes for included resources displayed in administrative interfaces.
version integer optional
Internal version counter for policy changes enabling conflict detection and synchronization tracking across device updates and modifications.
≥ 0
segmentId integer optional
Segment identifier for scoping policy into an specific segment
≥ 0
updatedAt string optional
ISO 8601 timestamp indicating the last time this record was modified in the database useful for tracking changes, synchronization processes, and maintaining audit trails of all modifications.
Format: date-time
createdAt string optional
ISO 8601 timestamp indicating when this record was initially created in the database providing historical context, chronological ordering capabilities, and analytics for lifecycle tracking and reporting.
Format: date-time
priority integer optional
Policy assignment priority determining precedence when multiple policies apply to device for conflict resolution.
≥ 0
winPolicyAssignmentsEnforced array [object] optional
Windows policy assignments with automation rule attribution documenting assignment triggers.
winPolicyId string optional
Windows MDM policy unique identifier for assignment tracking and policy composition workflows.
Match pattern: ^[a-fA-F0-9]{24}$
winPolicy object optional
Complete Windows MDM policy object with device security restrictions and application deployment configurations.
id string optional
Unique identifier for this specific resource instance in the system following a standardized format enabling targeted operations, relationship mapping, and tracking across all platform endpoints and data stores.
Match pattern: ^[a-fA-F0-9]{24}$
organizationId string optional
Organization identifier indicating workspace ownership for access control and data isolation across multi-tenant environments.
Match pattern: ^[a-fA-F0-9]{24}$
winEnterpriseId string optional
Windows enterprise configuration identifier linking policy to specific enrollment settings and device management context.
Match pattern: ^[a-fA-F0-9]{24}$
name string optional
Policy display name shown in interfaces and used for identification in listings and device assignments.
≤ 256 characters
config object optional
OMA-DM configuration object containing registry settings, security policies, and device restrictions to apply on managed Windows devices.
applications array [object] optional
Array of application assignments included in policy enabling bundled deployment and management of software packages.
applicationsInfo array [object] optional
Application metadata array containing name, version, and publisher details for included apps displayed in interfaces.
bookmarks array [object] optional
scripts array [object] optional
Array of script assignments included in policy enabling automated PowerShell or batch command operations.
scriptsInfo array [object] optional
Script metadata array containing name, description, and timing details for included scripts providing comprehensive script information in interfaces.
admxConfigs array [object] optional
Array of ADMX configuration assignments enabling group policy template settings for advanced Windows configurations.
admxConfigsInfo array [object] optional
ADMX configuration metadata array containing template details, settings types, and descriptions.
agentConfiguration object optional
MDM agent configuration settings controlling agent deployment, permissions, and capabilities on managed devices.
assets array [object] optional
Array of file asset assignments included in policy enabling deployment of certificates, configuration files, or resources.
assetsInfo array [object] optional
Asset metadata array containing file names, types, and sizes for included resources displayed in administrative interfaces.
version integer optional
Internal version counter for policy changes enabling conflict detection and synchronization tracking across device updates and modifications.
≥ 0
segmentId integer optional
Segment identifier for scoping policy into an specific segment
≥ 0
updatedAt string optional
ISO 8601 timestamp indicating the last time this record was modified in the database useful for tracking changes, synchronization processes, and maintaining audit trails of all modifications.
Format: date-time
createdAt string optional
ISO 8601 timestamp indicating when this record was initially created in the database providing historical context, chronological ordering capabilities, and analytics for lifecycle tracking and reporting.
Format: date-time
priority integer optional
Policy assignment priority determining precedence when multiple policies apply to device for conflict resolution.
≥ 0
automationRule object optional
Automation rule object documenting which rule triggered policy assignment for audit trails and compliance reports.
id string optional
Match pattern: ^[a-fA-F0-9]{24}$
name string optional
≤ 256 characters
deviceAudiences array [object] optional
networkIp string optional
Device current network IP address captured during last status report for network-based filtering.
≤ 128 characters
_base object optional
Platform-specific raw API response object from Android Enterprise, Apple MDM, or Windows Intune for advanced debugging.
deviceEmmPolicy object optional
Android Enterprise policy actually applied on device, may lag behind assigned policy during sync operations.
id string optional
≤ 128 characters
name string optional
≤ 256 characters
version string optional
≤ 128 characters
deviceAdmPolicy object optional
Apple Device Management policy actually installed on device, distinct from assigned policy during profile updates.
id string optional
≤ 128 characters
name string optional
≤ 256 characters
version string optional
≤ 128 characters
deviceWinPolicy object optional
Windows MDM policy actually enforced on device, may differ from assigned during synchronization delays.
id string optional
≤ 128 characters
name string optional
≤ 256 characters
version string optional
≤ 128 characters
createdAt string optional
Device record creation timestamp in database regardless of actual enrollment date.
Format: date-time
updatedAt string optional
Device record last modification timestamp reflecting any information changes in database.
Format: date-time
segmentId integer optional
Segment identifier for scoping devices into an specific segment
≥ 0
devicePolicyStatus object optional
Device policy status object indicating whether the device policy device has been pushed to the device
pushed boolean optional
audit object optional
name string optional
≤ 256 characters
config object optional
device object optional
totalDocs integer optional
≥ 0
{
    "status": true,
    "data": {
        "items": [
            {
                "id": "698f42e5457fafa13d088794",
                "type": "android",
                "subType": "device",
                "state": "ACTIVE",
                "organization": "698f42e5457fafa13d088795",
                "organizationInfo": {
                    "id": "698f42e5457fafa13d088795",
                    "name": "Acme Corp",
                    "slug": "acme"
                },
                "sortDate": "2024-03-15T14: 30: 00.000Z",
                "enrolledDate": "2024-03-15T14: 30: 00.000Z",
                "mdmUser": {
                    "id": "698f42e5457fafa13d088796",
                    "email": "[email protected]"
                },
                "displayName": "John Doe iPhone",
                "tags": [
                    "sales",
                    "remote",
                    "byod"
                ],
                "emmEnterprise": "698f42e5457fafa13d088797",
                "admEnterprise": "698f42e5457fafa13d088798",
                "emmDevice": "698f42e5457fafa13d088799",
                "lastStatusReportTime": "2024-03-20T10: 15: 00.000Z",
                "summary": {
                    "name": "string",
                    "osVersion": "string",
                    "managementMode": "DEVICE_OWNER",
                    "imei": "string",
                    "battery": "string",
                    "expirationTimestamp": "2024-01-01T00: 00:00Z",
                    "os": "string",
                    "serialNumber": "string",
                    "supervised": true,
                    "compliance": {},
                    "image": "string",
                    "manufacturer": "string",
                    "model": "string",
                    "udid": "string",
                    "hostname": "string",
                    "ipAddress": "string",
                    "macAddress": "string"
                },
                "emmPolicy": {
                    "id": "698f42e5457fafa13d08879a",
                    "name": "Corporate Android Security",
                    "version": "3"
                },
                "admPolicy": {
                    "id": "698f42e5457fafa13d08879b",
                    "name": "Corporate iOS Security",
                    "version": "2"
                },
                "appliedEmmPolicy": {
                    "id": "698f42e5457fafa13d08879a",
                    "name": "Corporate Android Security",
                    "version": "3"
                },
                "admPolicyAssignments": [
                    {
                        "admPolicyId": "698f42e5457fafa13d08879c",
                        "admPolicy": {},
                        "priority": 1
                    }
                ],
                "admPolicyAssignmentsEnforced": [
                    {
                        "admPolicyId": "698f42e5457fafa13d08879c",
                        "admPolicy": {},
                        "priority": 1,
                        "automationRule": {
                            "id": "698f42e5457fafa13d08879d",
                            "name": "Sales Team iOS Policies",
                            "deviceAudiences": [
                                {
                                    "id": "698f42e5457fafa13d0887a7",
                                    "name": "Sales Department",
                                    "reasons": [
                                        "tag:sales",
                                        "user.department:Sales"
                                    ]
                                }
                            ]
                        }
                    }
                ],
                "lastLocation": {
                    "agent": {
                        "origin": "agent",
                        "date": "2024-01-01T00: 00:00Z",
                        "latitude": 0,
                        "longitude": 0,
                        "ip": "string",
                        "lastReportDate": "2024-01-01T00: 00:00Z",
                        "address": {
                            "address": "string",
                            "number": "string",
                            "postalCode": "string",
                            "city": "string",
                            "country": "string"
                        }
                    },
                    "ip": {
                        "origin": "agent",
                        "date": "2024-01-01T00: 00:00Z",
                        "latitude": 0,
                        "longitude": 0,
                        "ip": "string",
                        "lastReportDate": "2024-01-01T00: 00:00Z",
                        "address": {
                            "address": "string",
                            "number": "string",
                            "postalCode": "string",
                            "city": "string",
                            "country": "string"
                        }
                    }
                },
                "admVppLocation": "698f42e5457fafa13d0887a0",
                "lostMode": {
                    "enabled": true,
                    "startDate": "2024-03-25T09: 00: 00.000Z",
                    "endDate": "2024-03-26T15: 30: 00.000Z",
                    "stoppedBy": "admin",
                    "lastLocation": {
                        "latitude": 407128,
                        "longitude": 74006,
                        "batteryLevel": 45
                    }
                },
                "emmPolicyAssignments": [
                    {
                        "emmPolicyId": "698f42e5457fafa13d08879f",
                        "emmPolicy": {},
                        "priority": 1
                    }
                ],
                "emmPolicyAssignmentsEnforced": [
                    {
                        "emmPolicyId": "698f42e5457fafa13d08879f",
                        "emmPolicy": {},
                        "priority": 1,
                        "automationRule": {
                            "id": "698f42e5457fafa13d0887a1",
                            "name": "Android Corporate Policy",
                            "deviceAudiences": []
                        }
                    }
                ],
                "winPolicy": {
                    "id": "698f42e5457fafa13d0887a2",
                    "name": "Corporate Windows Security",
                    "version": "1"
                },
                "winPolicyAssignments": [
                    {
                        "winPolicyId": "698f42e5457fafa13d0887a3",
                        "winPolicy": {},
                        "priority": 1
                    }
                ],
                "winPolicyAssignmentsEnforced": [
                    {
                        "winPolicyId": "698f42e5457fafa13d0887a3",
                        "winPolicy": {},
                        "priority": 1,
                        "automationRule": {
                            "id": "698f42e5457fafa13d0887a4",
                            "name": "Windows Corporate Policy",
                            "deviceAudiences": []
                        }
                    }
                ],
                "networkIp": "10.0.1.25",
                "_base": {},
                "deviceEmmPolicy": {
                    "id": "698f42e5457fafa13d08879a",
                    "name": "Corporate Android Security",
                    "version": "3"
                },
                "deviceAdmPolicy": {
                    "id": "698f42e5457fafa13d08879b",
                    "name": "Corporate iOS Security",
                    "version": "2"
                },
                "deviceWinPolicy": {
                    "id": "698f42e5457fafa13d0887a2",
                    "name": "Corporate Windows Security",
                    "version": "1"
                },
                "createdAt": "2024-03-15T14: 30: 00.000Z",
                "updatedAt": "2024-03-20T16: 45: 00.000Z",
                "segmentId": "1",
                "devicePolicyStatus": {
                    "pushed": true,
                    "audit": {
                        "name": "policyName",
                        "config": {
                            "version": "1"
                        },
                        "device": {
                            "version": "1"
                        }
                    }
                }
            }
        ],
        "totalDocs": 0
    }
}
401 Response application/json
status boolean optional
false
error object optional
code number optional
4001
message string optional
Unauthorized
{
    "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"
    }
}