Inspect the Inventory Change History

Applies to: Inventory API

Learn how to retrieve the inventory change history for an item.

Link to section

Overview

To inspect the history of inventory adjustments and the reset of physical counts for a specific item variation (for example, to create an audit log), call the RetrieveInventoryChanges endpoint, while specifying the item variation with the catalog_object_id URL path parameter value. You can also use the location_id query parameter to filter the result by location.

To inspect the history of inventory changes for multiple item variations, call the BatchRetrieveInventoryChanges endpoint, while specifying the desired input parameters in the request body.

Link to section

Retrieve inventory changes of a specific item variation

The cURL example retrieves the change history of the item variation identified by its ID value of 6F4K33KPNUVDWKZ43KUIFH6K.

Link to section

Request: Retrieve the change history of a single item variation

Retrieve inventory changes

Link to section

Response: Retrieve the change history of a single item variation

A successful response is shown as follows.

In this example, the history includes:

  • An adjustment that adds 100 units to the inventory when the inventory state changed from NONE to IN_STOCK.
  • An adjustment that marks 2 units as damaged items when the inventory state changed from IN_STOCK to WASTE.
  • A reset of the in-stock count by an actual physical count.
Link to section

Retrieve inventory changes of multiple item variations

The following cURL example retrieves the change history of the item variations identified by their ID values of 6F4K33KPNUVDWKZ43KUIFH6K and IJBAQDICELYUAUTHM352X3AI. The input values are specified in the catalog_object_ids of the request body.

Link to section

Request: Retrieve inventory changes of multiple item variations

Batch retrieve inventory changes

Link to section

Response: Retrieve inventory changes of multiple item variations

A successful response is shown as follows. In this example, the change history includes:

  • An adjustment that adds 100 units of the first item variation (6F4K33KPNUVDWKZ43KUIFH6K) to the inventory when the inventory state changed from NONE to IN_STOCK.
  • An adjustment that marks 2 units of the first item variation (6F4K33KPNUVDWKZ43KUIFH6K) as damaged items when the inventory state changed from IN_STOCK to WASTE.
  • A reset of the in-stock count of the first item variation (6F4K33KPNUVDWKZ43KUIFH6K) by an actual physical count of 95.
  • A reset of the in-stock count of the second item variation (IJBAQDICELYUAUTHM352X3AI) that adds 75 units to the inventory.