---
title: "List accessory asset history"
method: GET
path: "/assets/accessories/{id}/history"
tags: ["Assets"]
---

# List accessory asset history

`GET /assets/accessories/{id}/history`

## Request

- Base URL: `https://console.jumpcloud.com/api/v2`
- URL: `https://console.jumpcloud.com/api/v2/assets/accessories/{id}/history`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/docs/assets/accessories/:id/history/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the history of an accessory asset

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `skip` integer

## Response `200`

Accessory asset history retrieved successfully

- JumpcloudHttpAssetsAssetHistoryResponse: Response containing paginated asset history events
  - `results` JumpcloudHttpAssetsAssetHistoryEvent[], required: Array of asset history events
    - `eventType` 'ASSET_HISTORY_EVENT_TYPE_CREATE' | 'ASSET_HISTORY_EVENT_TYPE_DELETE' | 'ASSET_HISTORY_EVENT_TYPE_UPDATE_FIELDS' | 'ASSET_HISTORY_EVENT_TYPE_UPDATE_STATUS' | 'ASSET_HISTORY_EVENT_TYPE_UPDATE_LOCATION' | 'ASSET_HISTORY_EVENT_TYPE_UPDATE_OWNER' | 'ASSET_HISTORY_EVENT_TYPE_UPDATE_AGENT_STATUS' | 'ASSET_HISTORY_EVENT_TYPE_UPDATE_MFA_STATUS' | 'ASSET_HISTORY_EVENT_TYPE_UPDATE_MDM_STATUS' | 'ASSET_HISTORY_EVENT_TYPE_NOTE', required: The type of history event
    - `note` string: Note content for note events
    - `changedFields` JumpcloudHttpAssetsFieldChange[]
      - `label` string, required: The field label that changed
      - `oldValue` JumpcloudHttpAssetsChangeValue: Represents a field value in asset history (before/after change)
        - `value` unknown
      - `newValue` JumpcloudHttpAssetsChangeValue: Represents a field value in asset history (before/after change)
        - `value` unknown
    - `occurredAt` string, date-time, required: When the event occurred
    - `actor` JumpcloudHttpAssetsActor, required: Represents who performed an action on an asset
      - `id` string: The actor's unique identifier
      - `name` string, required: The actor's name
      - `type` 'ACTOR_TYPE_USER' | 'ACTOR_TYPE_SYSTEM' | 'ACTOR_TYPE_SERVICE_ACCOUNT' | 'ACTOR_TYPE_SYSTEM_USER', required: The type of actor
    - `actionSource` 'ACTION_SOURCE_MANUAL' | 'ACTION_SOURCE_SYSTEM' | 'ACTION_SOURCE_IMPORT' | 'ACTION_SOURCE_API', required: Source of the action
  - `totalCount` integer, required: Total number of history events available (for pagination)

## Other responses

- `400`: Bad request - invalid asset ID or parameters
- `401`: Unauthorized - authentication required
- `404`: Accessory asset not found
- `default`: Generic error response

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/revisions/3f09fe63caaa?raw)