Retrieve individual command action results

GET

/v1/organizations/:organizationId/mdm/windows/enterprise/devices/:winDeviceId/commands/:winCommandId/actions

Retrieve individual command action results

Required Permission: mdm.windows.command.get

Retrieve paginated list of individual command actions within batch showing processing status, responses, and error details per operation.

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

winDeviceId string

required

Match pattern: ^(([a-fA-F0-9]{24})|(\w{1,}))$

winCommandId string

required

Windows command batch identifier used for retrieving, updating, or canceling specific command operations.

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

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 individual command actions with configuration details enabling inspection of batch operations.

cmdId string optional

Unique identifier for individual command action within batch enabling granular status tracking and cancellation.

≤ 128 characters

status string optional

Command processing status indicating current execution state such as pending, acknowledged, or various error conditions.

Pending Awaiting UnexpectedError Acknowledged Cancel MethodNotAllowed Unknown Unauthorized CommandFormatError CommandNotFound NotSupported DeleteWithoutArchive ItemNotDeleted AuthenticationAccepted ChunkedItemAcceptedAndBuffered OperationCanceled CommandNotExecutedUserCanceled CommandInsideAtomicElementAndAtomicFailed RequestedTargetIsOneOfMultipleAlternativesRequestedTarget RequestedTargetHasANewURI RequestedTargetMovedToADifferentURI RequestedTargetCanBeFoundAtAnotherURI RequestedSyncMLCommandNotExecutedOnTarget RequestedTargetMustBeAccessedThroughSpecifiedProxyURI PaymentIsNeeded FailedByRecipientUnderstoodTheCommand InvalidOriginatorAuthentication ExpectedMessageNotReceivedInRequiredPeriodOfTime UpdateConflictBetweenClientAndServerVersion TargetNotLongerAvailable CommandMustBeAccompaniedByByteSizeOrLength IncompleteOrIncorrectFormed RequestItemTooLong TargetURIIsTooLong UnsupportedMediaType ByteSizeTooBig RequestFailRetryAfterSomeTime PutOrAddCommandFailedBecauseTargetAlreadyExists ConflictDetectedResolvedServerCommandWinning NoMoreStorageSpaceForRemainingSynchronizationData SpecifiedSearchGrammarWasNotKnown CGIScriptingInLocURIWasIncorrectlyFormed SoftDeletedItemAlreadyHardDeleted ChunkedObjectReceivedByIncorrectSizeDeclared InvalidAdequateAccessControlPermissions PartialItemNotAccepted ParentCanNotBeDeletedSinceItContainsChildren MoveFailed CommandNotSupported GatewayOrProxyError TemporaryOverloadingOrMaintenanceError GatewayOrProxyTimeout InvalidSyncMLDTDVersion ApplicationErrorWhileProcessingTheRequest ErrorCausedAllSyncMKCommandsFail ErrorARefreshSynchronizationIsNeeded ReservedForFutureUse ErrorInRecipientDataStore SevereErrorInServer ApplicationErrorDuringSynchronization SyncMLSynchronizationVersionNotSupported SyncMlCommandCanceled AtomicRollbackFailed AtomicResponseTooLarge MalformedSyntax

config object optional

Command configuration object containing the registry path, action type, and value to apply on the target device.

path string optional

OMA-DM or CSP registry path targeting specific device setting or policy configuration location.

≤ 500 characters

action string optional

Operation type to perform on the target path such as add, replace, delete, get, exec, or copy.

Add Copy Delete Exec Get Replace

value string optional

Configuration value to apply at the target path encoded according to the specified format.

≤ 500 characters

data array [object] optional

Response data array returned by device after command execution containing status codes and result payloads.

statusCode integer optional

HTTP-style status code indicating command execution result from the device agent.

≥ 0

sentAt string optional

Timestamp when command was sent to device for processing enabling execution time tracking.

Format: date-time

receivedAt string optional

Timestamp when device acknowledged receipt of command indicating communication success.

Format: date-time

canceledAt string optional

Timestamp when command was canceled by administrator preventing further processing on device.

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": [
            {
                "cmdId": "cmd-550e8400-e29b-41d4",
                "status": "Acknowledged",
                "config": {
                    "path": "./Device/Vendor/MSFT/Policy/Config/Security/RequireDeviceEncryption",
                    "action": "Replace",
                    "value": "1"
                },
                "data": [
                    {}
                ],
                "statusCode": 200,
                "sentAt": "2026-02-10T10: 05: 00.000Z",
                "receivedAt": "2026-02-10T10: 05: 15.000Z",
                "canceledAt": "2026-02-10T10: 06: 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"
    }
}