---
title: "Find inventory events based on search parameters."
method: POST
path: "/api/inventory-events/list"
tags: ["Inventory Event"]
---

# Find inventory events based on search parameters.

`POST /api/inventory-events/list`

## Query parameters

- `Sort.Field` string
- `Sort.Dir` 'ascending' | 'descending' — Specify sorting direction.
- `Skip` integer
- `Take` integer

## Request body

- InventoryEventRequestFindParameters — Parameters used for searching/finding inventory.
  - `createdBeforeUtc` string, date-time, nullable — Filters events created before (exclusive) this parameter in UTC time. If no time component is passed, midnight UTC will be used.
  - `createdAfterUtc` string, date-time, nullable — Filters events created after (exclusive) this parameter in UTC time. If no time component is passed, midnight UTC will be used.
  - `types` InventoryEventType[], nullable — Inventory event type(s).
  - `secondaryTypes` InventoryEventSecondaryType[], nullable — Inventory event secondary type(s).
  - `sourceTypes` InventoryEnumEventSourceType[], nullable — Inventory event source type(s).
  - `itemIds` string[], nullable — Item id. Please reference /api/items endpoint.
  - `itemToMakeIds` string[], nullable — Item id. Please reference /api/items endpoint.
  - `reservedForTypes` DomainCommonEntityType[], nullable — Inventory reservation types.
  - `reservedForIds` string[], nullable — Inventory reservation ids.
  - `inventoryEventIds` string[], nullable — Inventory event ids.

## Response `200`

List of inventory events matching the filters

- DtoPagedResultDtoInventoryEventsInventoryEventDto — Paged result
  - `data` InventoryEventsInventoryEventDto[], required — The data
    - `id` string, required — Id
    - `actionDate` string, date-time, nullable — The date of the action.
    - `type` 'pick' | 'receive' | 'revert' | 'adjustment' | 'setItemValue' | 'eventOverride', required — Primary inventory event type.
    - `secondaryType` 'pick' | 'receive' | 'override' | 'revert' | 'deposit' | 'create' | 'consume' | 'ship' | 'sold' | 'transferOut' | 'transferIn' | 'found' | 'expired' | 'damaged' | 'lost' | 'returnVendor' | 'returnStock' | 'receivedNoPo' | 'returnIncrease' | 'returnDecrease' | 'otherIncrease' | 'otherDecrease' | 'scrap' | 'waste' | 'transferredFromSalesOrder' | 'overrideItemValue' | 'transferFromLot' | 'transferToLot' | 'stockAdjustmentIncrease' | 'stockAdjustmentDecrease' | 'stockTake' — Secondary, verbose description for an event.
    - `sourceType` 'purchaseOrder' | 'job' | 'shipment' | 'shipmentLineItem' | 'shipping' | 'receiving' | 'item' | 'workOrder' | 'salesOrder' | 'jobOperation' | 'workOrderOperation' | 'fulfillment' | 'itemToMakeMaterialRemnant' | 'poRcvValueAdj' — Indicator for the initial source of the event.
    - `sourceName` string, nullable — Source name.
    - `sourceEntityId` string, nullable — Source entity id
    - `sourceRelatedType` 'purchaseOrder' | 'job' | 'shipment' | 'shipmentLineItem' | 'shipping' | 'receiving' | 'item' | 'workOrder' | 'salesOrder' | 'jobOperation' | 'workOrderOperation' | 'fulfillment' | 'itemToMakeMaterialRemnant' | 'poRcvValueAdj' — Indicator for the initial source of the event.
    - `sourceRelatedEntityId` string, nullable — Related source entity id
    - `sourceItemToMakeId` string, nullable — Source item to make id. Please reference /api/jobs/{jobId}/items-to-make endpoint.
    - `itemId` string, nullable — Item id key identifier. Please reference /api/items endpoint.
    - `itemToMakeId` string, nullable — Item to make id key identifier. Please reference /api/jobs/{jobId}/items-to-make endpoint.
    - `quantity` number, double, required — Quantity.
    - `laborValue` CommonCostDto — Cost information
      - `total` number, double, required — Total
      - `perUnit` number, double, required — Cost per unit
    - `machineValue` CommonCostDto — Cost information
      - `total` number, double, required — Total
      - `perUnit` number, double, required — Cost per unit
    - `outsideProcessingValue` CommonCostDto — Cost information
      - `total` number, double, required — Total
      - `perUnit` number, double, required — Cost per unit
    - `materialValue` CommonCostDto — Cost information
      - `total` number, double, required — Total
      - `perUnit` number, double, required — Cost per unit
    - `totalValue` CommonCostDto — Cost information
      - `total` number, double, required — Total
      - `perUnit` number, double, required — Cost per unit
    - `reservedForId` string, nullable — This is the id for the underlying entity that this inventory is reserved for.
    - `reservedForType` 'job' | 'salesOrder' | 'shipment' | 'shipmentLineItem' | 'invoice' | 'invoiceLineItem' | 'customer' | 'customerAddress' | 'item' | 'receivingInspection' | 'failedInspection'
    - `lotId` string, nullable — The lot this inventory is allocated to. Please reference /api/inventory-lots endpoint.
    - `locationId` string, nullable — The location this inventory is allocated to. Please reference /api/locations endpoint.
    - `revertInventoryEventId` string, nullable — If the event is intended to "revert" a previous transaction, this value contains the original event.
    - `note` string, nullable — A note associated to this event.
    - `resultEffects` DtoInventoryEventsInventoryEventChangeDetails — Inventory event change information.
      - `transactionId` string, required — The resulting "transaction" id. Please reference /api/inventory-transactions endpoint.
      - `quantity` number, double, required — Quantity
      - `quantityChangeType` 'increase' | 'decrease' | 'static'
      - `laborValue` CommonCostDto — Cost information
        - `total` number, double, required — Total
        - `perUnit` number, double, required — Cost per unit
      - `machineValue` CommonCostDto — Cost information
        - `total` number, double, required — Total
        - `perUnit` number, double, required — Cost per unit
      - `outsideProcessingValue` CommonCostDto — Cost information
        - `total` number, double, required — Total
        - `perUnit` number, double, required — Cost per unit
      - `materialValue` CommonCostDto — Cost information
        - `total` number, double, required — Total
        - `perUnit` number, double, required — Cost per unit
      - `totalValue` CommonCostDto — Cost information
        - `total` number, double, required — Total
        - `perUnit` number, double, required — Cost per unit
      - `netValueChange` CommonCostDto — Cost information
        - `total` number, double, required — Total
        - `perUnit` number, double, required — Cost per unit
    - `details` InventoryEventDetailsDto — Inventory event details. Additional metadata for Inventory Events.
      - `externalReferences` object, nullable — External references associated with this entity.
  - `page` integer, required — The 1-indexed page
  - `pageSize` integer, required — The page size
  - `totalCount` integer, required — The total count of records
  - `totalPages` integer, required — The total pages
  - `hasPreviousPage` boolean, required — True if there is a previous page
  - `hasNextPage` boolean, required — True if there is a next page

---

[API](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fulcrumpro/fulcrum-publicapi/versions/1b5649cff14a/schema)