Retrieve OS version distribution statistics

GET

/v1/organizations/:organizationId/mdm/devices/os-versions

Retrieve OS version distribution statistics

Required Permission: mdm.global.device.list

Retrieves aggregated operating system version distribution across managed fleet with device counts per version, essential for update planning and security compliance auditing.

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,}))$

os string

optional

Operating system platform filter or identifier for platform-specific queries and version statistics.

androidiosmacoswindows

Responses

200 Response application/json

status boolean optional

data object optional

items array [object] optional

value string optional

Filter parameter for operating system version enabling version-specific device targeting for updates.

≤ 256 characters

os string optional

Operating system platform filter or identifier for platform-specific queries and version statistics.

android ios macos windows

count integer optional

Number of devices running specific OS version for distribution analysis and upgrade planning.

≥ 0

{
    "status": true,
    "data": {
        "items": [
            {
                "value": "17.3.1",
                "os": "ios",
                "count": 47
            }
        ]
    }
}

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