List device management policies

GET

/v1/organizations/:organizationId/mdm/policies/

List device management policies

Required Permission: mdm.global.policy.list

Returns a paginated list of policies from Android, Apple, and Windows platforms accessible within the organization context.

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

Sequential page index for navigating large datasets, enabling systematic access to specific record subsets within the total collection.

limit integer

optional

Maximum number of records returned per request to control data density, optimize interface performance, and manage payload size

sort string

optional

Ordering criteria using a field-to-direction mapping to organize results based on specific attributes like creation date, name, or status.

Match pattern: ^[\w.]*((:asc)|(:desc))?$

type string

optional

Platform identifier indicating whether policy applies to Android, Apple, or Windows devices determining schema structure and enforcement mechanisms used.

androidapplewindows

name string

optional

Filter parameter matching policies by exact or partial name enabling administrators to locate specific configurations within large policy inventories.

≤ 256 characters

policyId string

optional

Filter parameter restricting results to single policy by unique identifier supporting direct policy lookup for administrative and debugging operations.

Match pattern: ^[a-fA-F0-9]{24}$

search string

optional

Full-text search parameter matching policies by name or identifier enabling flexible discovery across policy catalogs without requiring exact matches.

≤ 256 characters

segmentId integer

optional

Segment identifier for scoping policy into an specific segment

expandTo string

optional

Param to include ancestor or child related entities

ancestorschildren

Responses

200 Response application/json

status boolean optional

data object optional

items array [object] optional

id string optional

Unique identifier for the policy record used across platform-specific implementations to maintain referential integrity and enable cross-platform policy tracking.

Match pattern: ^[a-fA-F0-9]{24}$

type string optional

Platform identifier indicating whether policy applies to Android, Apple, or Windows devices determining schema structure and enforcement mechanisms used.

android apple windows

name string optional

Human-readable policy name assigned by administrators for identification purposes within the management console and organizational documentation workflows.

≤ 256 characters

version integer optional

Incremental version number tracking policy configuration changes enabling administrators to monitor evolution and maintain deployment history for compliance auditing.

≥ 0

counts object optional

Aggregated metrics quantifying policy scope and complexity including affected devices, managed applications, and configured properties for operational visibility.

devices integer optional

Total number of devices currently assigned this policy through direct assignment or automation rules enabling capacity planning and impact assessment.

≥ 0

applications integer optional

Count of applications referenced within policy configuration including managed apps, restrictions, and permissions governing application availability and behavior.

≥ 0

properties integer optional

Number of distinct configuration properties defined within policy schema providing complexity measurement for troubleshooting and optimization analysis.

≥ 0

targetType string optional

Apple device category constraint specifying whether policy targets iPhone, iPad, macOS, or tvOS devices affecting profile payload compatibility and deployment.

device deviceUser

updatedAt string optional

Timestamp recording the most recent policy modification enabling change tracking and synchronization detection across distributed device management infrastructure.

Format: date-time

createdAt string optional

Timestamp marking initial policy creation providing audit trail foundation and enabling time-based filtering for policy lifecycle management operations.

Format: date-time

agentConfiguration object optional

Agent behavior settings controlling data collection permissions and feature availability for companion management agents deployed alongside policy configurations.

allowLocation boolean optional

Permission flag enabling location tracking on managed iOS and Android devices providing geofencing capabilities and asset tracking for mobile deployments.

allowLocationMacos boolean optional

Permission flag enabling location services specifically for macOS devices supporting desktop asset tracking and compliance verification for remote workforces.

allowPackageTime boolean optional

Permission flag enabling timestamp tracking for package installations providing deployment analytics and compliance monitoring for software distribution workflows.

allowPackageTransfer boolean optional

Permission flag enabling package transfer capabilities allowing managed devices to distribute application binaries peer-to-peer reducing bandwidth costs and improving deployment.

allowDeviceInfoBatteryUsage boolean optional

Permission flag enabling battery usage statistics collection providing power consumption analytics for application optimization and device health monitoring.

allowDeviceInfoBluetooth boolean optional

Permission flag enabling Bluetooth adapter information collection supporting proximity detection and peripheral inventory for security and asset management.

allowDeviceInfoSystemInfo boolean optional

Permission flag enabling comprehensive system information collection including hardware specifications, OS versions, and runtime metrics for inventory management.

totalDocs integer optional

{
    "status": true,
    "data": {
        "items": [
            {
                "id": "507f1f77bcf86cd799439011",
                "type": "android",
                "name": "Corporate Security Baseline Policy",
                "version": 3,
                "counts": {
                    "devices": 247,
                    "applications": 12,
                    "properties": 38
                },
                "targetType": "device",
                "updatedAt": "2026-02-10T14: 30:00Z",
                "createdAt": "2026-02-01T09: 15:00Z",
                "agentConfiguration": {
                    "allowLocation": true,
                    "allowLocationMacos": false,
                    "allowPackageTime": true,
                    "allowPackageTransfer": false,
                    "allowDeviceInfoBatteryUsage": true,
                    "allowDeviceInfoBluetooth": true,
                    "allowDeviceInfoSystemInfo": true
                }
            }
        ],
        "totalDocs": 0
    }
}

401 Response application/json

status boolean optional

false

error object optional

code number optional

4004

message string optional

Invalid Token

{
    "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"
    }
}