GET /organizations/:organizationId/mdm/policies

GET

https://api.applivery.io/v1/organizations/{organizationId}/mdm/policies

curl -X GET "https://api.applivery.io/v1/organizations/{organizationId}/mdm/policies" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

const response = await fetch("https://api.applivery.io/v1/organizations/{organizationId}/mdm/policies", {
  method: "GET",
  headers: {
    Authorization: "Bearer <YOUR_API_KEY>",
  },
});

const data = await response.json();

import requests

response = requests.get(
    "https://api.applivery.io/v1/organizations/{organizationId}/mdm/policies",
    headers={"Authorization": "Bearer <YOUR_API_KEY>"},
)

data = response.json()

Request

Send your API key in the request 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.

androidapplewindowsaosp

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 aosp

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.

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

exposeToChildren boolean optional

agentConfiguration object optional

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

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",
                "exposeToChildren": true,
                "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"
    }
}

Request

Authorization

Path Params1

Query Params9

Responses