GET /organizations/:organizationId/mdm/aosp/enterprise/devices

GET

/v1/organizations/:organizationId/mdm/aosp/enterprise/devices

List non-GMS Android devices

Required Permission: mdm.aosp.device.list

Retrieve non-GMS Android devices for the enterprise using the lean list response shape.

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 paginated AOSP device results.

limit integer

optional

Maximum number of AOSP devices to return per page.

sort string

optional

Sort expression applied to the AOSP device list.

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

mdm-user string

optional

Filter devices associated with a specific MDM user identifier.

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

aos-policy string

optional

Filter devices linked to a specific directly assigned AOSP policy.

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

show-deleted any

optional

Include deleted devices in the result set.

segmentId integer

optional

Optional segment identifier used to scope the resource within the organization.

expandTo string

optional

Segment expansion mode applied when filtering by segment.

ancestorschildren

state any

optional

Filter devices by one or more backend states.

tags any

optional

Filter devices that contain one or more of the provided tags.

Responses

200 Response application/json

status boolean required

data object required

items array [object] required

id string required

Identifier of the AOSP device.

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

organizationId string required

Identifier of the organization that owns the AOSP enterprise resource.

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

aosEnterpriseId string required

Identifier of the AOSP enterprise configuration associated with this resource.

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

pushNotificationProvider string optional

Optional push notification provider override used for this enterprise or resource.

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

segmentId integer optional

Optional segment identifier used to scope the resource within the organization.

≥ 0 · ≤ 9007199254740991

displayName string optional

Optional human-friendly label shown in the dashboard.

≤ 256 characters

tags array required

Free-form labels used to group and filter AOSP resources in the dashboard.

state string required

Current backend-managed lifecycle state of the device.

PROVISIONING ACTIVE DISABLED PENDING_DISENROLL DELETED

type string required

Top-level MDM device type for this resource.

aosp

subType string required

Subtype of the AOSP resource returned by this endpoint.

device

mdmUser object optional

Optional dashboard user metadata associated with the device.

aosPolicyId string optional

Identifier of the directly assigned AOSP policy, when present.

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

aosPolicy object optional

Summary of the effective directly assigned AOSP policy.

deviceAosPolicy object optional

Expanded effective device policy returned for the device detail view.

aosPolicyAssignments array [object] required

Ordered AOSP policy assignments used to compose the effective device policy.

devicePolicyStatus object optional

Comparison between the effective policy and the last reported device state.

config object optional

Last known AOSP device configuration and reports recorded by the backend.

summary object optional

Latest backend summary captured from device reports and inventory processing.

stateHistory array [object] optional

Historical record of state transitions recorded by the backend.

lastStatusReportTime string optional

Timestamp of the most recent status report received from the device.

enrolledDate string required

Timestamp when the device was enrolled, or resource creation time when unavailable.

updatedAt string required

Timestamp when the resource was last updated.

createdAt string required

Timestamp when the resource was created.

totalDocs integer required

≥ -9007199254740991 · ≤ 9007199254740991

limit integer required

≥ -9007199254740991 · ≤ 9007199254740991

hasPrevPage boolean required

hasNextPage boolean required

page integer required

≥ -9007199254740991 · ≤ 9007199254740991

totalPages integer required

≥ -9007199254740991 · ≤ 9007199254740991

prevPage integer required

≥ -9007199254740991 · ≤ 9007199254740991

nextPage integer required

≥ -9007199254740991 · ≤ 9007199254740991

{
    "status": true,
    "data": {
        "items": [
            {
                "id": "string",
                "organizationId": "string",
                "aosEnterpriseId": "string",
                "pushNotificationProvider": "string",
                "segmentId": 0,
                "displayName": "string",
                "tags": [
                    "string"
                ],
                "state": "PROVISIONING",
                "type": "aosp",
                "subType": "device",
                "mdmUser": {
                    "id": "string",
                    "email": "string"
                },
                "aosPolicyId": "string",
                "aosPolicy": {
                    "id": "string",
                    "name": "string",
                    "version": "string"
                },
                "deviceAosPolicy": {
                    "id": "string",
                    "organizationId": "string",
                    "aosEnterpriseId": "string",
                    "name": "string",
                    "description": "string",
                    "config": "string",
                    "private": true,
                    "segmentId": 0,
                    "exposeToChildren": true,
                    "agentConfiguration": {
                        "allowLocation": true,
                        "allowPackageTime": true,
                        "allowPackageTransfer": true,
                        "allowNetworkStatus": true,
                        "policyFeatures": {
                            "defaultViewFeature": "bookmarks",
                            "toggledFeatures": [
                                {
                                    "name": "bookmarks",
                                    "active": true
                                }
                            ],
                            "enableDefaultView": true
                        }
                    },
                    "assets": [
                        {
                            "mdmAssetId": "string",
                            "location": "string",
                            "assetName": "string",
                            "scope": "user"
                        }
                    ],
                    "assetsInfo": [
                        {}
                    ],
                    "applications": [
                        {
                            "aosApplicationId": "string",
                            "configuration": "string",
                            "action": "forceInstall",
                            "updatePolicy": {},
                            "customAppConfig": {}
                        }
                    ],
                    "applicationsInfo": [
                        {
                            "id": "string",
                            "organizationId": "string",
                            "aosEnterpriseId": "string",
                            "type": "build",
                            "config": {
                                "buildId": "string",
                                "applicationId": "string",
                                "filter": "string"
                            },
                            "info": {
                                "id": "string",
                                "bundleId": "string",
                                "name": "string",
                                "icon": "string",
                                "processedVersionName": "string",
                                "versionCode": "string",
                                "size": "string",
                                "originalExtension": "string",
                                "applicationInfo": {
                                    "id": "string",
                                    "slug": "string",
                                    "name": "string",
                                    "picture": "string"
                                },
                                "disabled": true,
                                "signatures": {
                                    "sha1": "string",
                                    "sha256": "string"
                                }
                            },
                            "version": 0,
                            "updatedAt": "string",
                            "createdAt": "string"
                        }
                    ],
                    "certificateProviderIds": [
                        "string"
                    ],
                    "version": 0,
                    "updatedAt": "string",
                    "createdAt": "string"
                },
                "aosPolicyAssignments": [
                    {
                        "aosPolicyId": "string",
                        "aosPolicy": {
                            "id": "string",
                            "name": "string",
                            "version": "string"
                        },
                        "priority": 0
                    }
                ],
                "devicePolicyStatus": {
                    "pushed": true,
                    "audit": {
                        "name": "string",
                        "config": {
                            "version": "string"
                        },
                        "device": {
                            "version": "string"
                        }
                    }
                },
                "config": {
                    "deviceReport": {
                        "name": "string",
                        "userName": "string",
                        "managementMode": "string",
                        "state": "string",
                        "appliedState": "string",
                        "policyCompliant": true,
                        "nonComplianceDetails": [
                            {}
                        ],
                        "enrollmentTime": "string",
                        "lastStatusReportTime": "string",
                        "lastPolicyComplianceReportTime": "string",
                        "lastPolicySyncTime": "string",
                        "policyName": "string",
                        "appliedPolicyName": "string",
                        "appliedPolicyVersion": "string",
                        "apiLevel": 0,
                        "enrollmentTokenData": "string",
                        "enrollmentTokenName": "string",
                        "disabledReason": {},
                        "softwareInfo": {
                            "androidVersion": "string",
                            "androidDevicePolicyVersionCode": 0,
                            "androidDevicePolicyVersionName": "string",
                            "androidBuildNumber": "string",
                            "deviceKernelVersion": "string",
                            "bootloaderVersion": "string",
                            "androidBuildTime": "string",
                            "securityPatchLevel": "string",
                            "primaryLanguageCode": "string",
                            "deviceBuildSignature": "string",
                            "systemUpdateInfo": {}
                        },
                        "hardwareInfo": {
                            "brand": "string",
                            "hardware": "string",
                            "deviceBasebandVersion": "string",
                            "manufacturer": "string",
                            "serialNumber": "string",
                            "model": "string",
                            "batteryShutdownTemperatures": [
                                0
                            ],
                            "batteryThrottlingTemperatures": [
                                0
                            ],
                            "cpuShutdownTemperatures": [
                                0
                            ],
                            "cpuThrottlingTemperatures": [
                                0
                            ],
                            "gpuShutdownTemperatures": [
                                0
                            ],
                            "gpuThrottlingTemperatures": [
                                0
                            ],
                            "skinShutdownTemperatures": [
                                0
                            ],
                            "skinThrottlingTemperatures": [
                                0
                            ],
                            "enterpriseSpecificId": "string",
                            "euiccChipInfo": [
                                {}
                            ]
                        },
                        "displays": [
                            {}
                        ],
                        "previousDeviceNames": [
                            "string"
                        ],
                        "networkInfo": {
                            "imei": "string",
                            "meid": "string",
                            "wifiMacAddress": "string",
                            "networkOperatorName": "string",
                            "telephonyInfos": [
                                {}
                            ]
                        },
                        "memoryInfo": {},
                        "memoryEvents": [
                            {}
                        ],
                        "powerManagementEvents": [
                            {}
                        ],
                        "hardwareStatusSamples": [
                            {}
                        ],
                        "deviceSettings": {},
                        "user": {},
                        "systemProperties": {},
                        "securityPosture": {},
                        "ownership": "string",
                        "commonCriteriaModeInfo": {},
                        "appliedPasswordPolicies": [
                            {}
                        ],
                        "dpcMigrationInfo": {},
                        "defaultApplicationInfo": [
                            {}
                        ]
                    },
                    "managementMode": "MANAGEMENT_MODE_UNSPECIFIED",
                    "location": {
                        "latitude": 0,
                        "longitude": 0,
                        "accuracy": 0
                    },
                    "appliedPolicy": {
                        "policyId": "string",
                        "status": "success",
                        "appliedAt": "string",
                        "errorMessage": "string"
                    }
                },
                "summary": {},
                "stateHistory": [
                    {
                        "state": "PROVISIONING",
                        "date": "string",
                        "config": {}
                    }
                ],
                "lastStatusReportTime": "string",
                "enrolledDate": "string",
                "updatedAt": "string",
                "createdAt": "string"
            }
        ],
        "totalDocs": 0,
        "limit": 0,
        "hasPrevPage": true,
        "hasNextPage": true,
        "page": 0,
        "totalPages": 0,
        "prevPage": 0,
        "nextPage": 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"
    }
}