GET /organizations/:organizationId/mdm/windows/enterprise/devices/:winDeviceId/applications/history

GET

/v1/organizations/:organizationId/mdm/windows/enterprise/devices/:winDeviceId/applications/history

List installed application management history.

Required Permission: mdm.windows.device.get

Retrieves chronological management events per application including install commands and status reports with device-reported data.

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

Windows device identifier used for targeting operations, supporting MongoDB ObjectId, IMEI, or serial number formats for flexible device lookup.

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

installsOnly boolean

optional

Whether or not to return only application installation commands. Returns all commands by default.

Responses

200 Response application/json

status boolean optional

data array [object] optional

package string optional

≤ 256 characters

winApplication object optional

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

organizationId string optional

Organization identifier indicating workspace ownership for access control and data isolation across multi-tenant environments.

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

winEnterpriseId string optional

Windows enterprise configuration identifier linking application to specific enrollment settings and device management context.

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

type string optional

Application source type specifying deployment strategy such as store, build, asset, or dynamic build references.

store build asset lastBuild lastGitBranchBuild lastGitTagBuild lastTagBuild

config object optional

Application configuration object containing source-specific identifiers and filtering rules for deployment.

info object optional

Application metadata object containing name, version, publisher, and display information.

origin string optional

Application origin designation indicating whether sourced from library or external catalog.

library

version integer optional

Internal version counter for application changes enabling conflict detection and synchronization tracking.

≥ 0

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

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

history array [object] optional

type string optional

≤ 128 characters

action string optional

≤ 128 characters

status string optional

≤ 128 characters

receivedAt string optional

Format: date-time

data object optional

{
    "status": true,
    "data": [
        {
            "package": "string",
            "winApplication": {
                "id": "507f1f77bcf86cd799439011",
                "organizationId": "507f1f77bcf86cd799439022",
                "winEnterpriseId": "507f1f77bcf86cd799439033",
                "type": "store",
                "config": {
                    "winStoreId": "9WZDNCRFHVJL",
                    "buildId": "507f1f77bcf86cd799439044",
                    "mdmAssetId": "507f1f77bcf86cd799439055",
                    "applicationId": "507f1f77bcf86cd799439066",
                    "filter": "branch:main"
                },
                "info": {
                    "name": "Microsoft Teams",
                    "version": "1.5.0",
                    "publisher": "Microsoft Corporation"
                },
                "origin": "library",
                "version": 3,
                "updatedAt": "2026-02-10T14: 30: 00.000Z",
                "createdAt": "2025-11-20T09: 00: 00.000Z"
            },
            "history": [
                {
                    "type": "string",
                    "action": "string",
                    "status": "string",
                    "receivedAt": "2024-01-01T00: 00:00Z",
                    "data": {}
                }
            ]
        }
    ]
}

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