Favicon

You are here: Home > API Reference > Windows > Windows Commands > Retrieve device command history

GET /organizations/:organizationId/mdm/windows/enterprise/devices/:winDeviceId/commands

Required Permission: mdm.windows.command.list

Retrieve list of issued configuration commands for specific Windows device showing processing status and summary of operations.

GET
https://api.applivery.io/v1/organizations/{organizationId}/mdm/windows/enterprise/devices/{winDeviceId}/commands 
curl -X GET "https://api.applivery.io/v1/organizations/{organizationId}/mdm/windows/enterprise/devices/{winDeviceId}/commands" \
  -H "Authorization: Bearer <YOUR_API_KEY>"
const response = await fetch("https://api.applivery.io/v1/organizations/{organizationId}/mdm/windows/enterprise/devices/{winDeviceId}/commands", {
  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/windows/enterprise/devices/{winDeviceId}/commands",
    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,}))$
winDeviceId string
required
Match pattern: ^(([a-fA-F0-9]{24})|(\w{1,}))$

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))?$

Responses

200 Response application/json
status boolean optional
data object optional
items array [object] optional
Array of command batch summaries matching query criteria with pagination support.
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}$
name string optional
Human-readable command batch name for identification in interfaces and reporting workflows.
≤ 500 characters
winDeviceId string optional
Windows device identifier targeting the specific managed endpoint for command execution and status tracking.
Match pattern: ^[a-fA-F0-9]{24}$
summary array [object] optional
Aggregated status summary showing count of commands in each processing state for quick overview.
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
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
totalDocs integer optional
Total count of items matching query criteria enabling pagination calculations and result set size awareness.
≥ 0
{
    "status": true,
    "data": {
        "items": [
            {
                "id": "507f1f77bcf86cd799439011",
                "name": "Security Policy Update",
                "winDeviceId": "507f1f77bcf86cd799439044",
                "summary": [
                    {
                        "status": "Acknowledged",
                        "action": "Replace",
                        "num": 5
                    }
                ],
                "createdAt": "2026-02-10T10: 00: 00.000Z",
                "updatedAt": "2026-02-10T14: 30: 00.000Z"
            }
        ],
        "totalDocs": 42
    }
}
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"
    }
}