# Get inventory transactions

This method allows a customer to retrieve inventory transactions. Inventory transactions include Sales Orders, Purchase Orders, Transfer In, Transfer Out, Production Lines, Inventory Adjustments and Inventory Status Changes. There are multiple input filters available for use, including filters to retrieve specific types of inventory transactions, to retrieve transactions processed on a particular date, or to retrieve transactions in a specific Wineshipping warehouse.There are also pagination and skip/top query parameters that allow customers to further control the inventory transactions that are returned in the response.

Endpoint: POST /api/Inventory/GetTransactions
Version: 3.1.3
Security: Authentication

## Request fields (application/json):

  - `Authentication` (object, required)
    Credentials are required for all API operations.

  - `Authentication.UserKey` (string, required)
    Example: "C445598CB576468EA35FBB22C55584EF"

  - `Authentication.Password` (string, required)
    Example: "AF63FDAC1E704DC1AC9460F669ABF107"

  - `Authentication.CustomerNo` (string, required)
    Example: "10703"

  - `TransactionDate` (string)
    Required unless  is specified. Format: MM/DD/YYYY
    Example: "12/31/2025"

  - `TransactionStartDateTime` (string)
    Required unless  is specified.
    Example: "2025-02-10T08:12:39.483Z (UTC)"

  - `TransactionEndDateTime` (string)
    Optional; valid only when  is specified.
    Example: "2017-02-10T08:12:39.483Z (UTC)"

  - `TransactionType` (string)
    Required unless  is specified instead

  - `TransactionTypes` (array)
    Required unless  is specified instead
    Enum: "Purchase Order", "Transfer In", "Transfer Out", "Production Line", "Inventory Adjustment", "Inventory Status Change", "Sales order", "Return Order"

  - `Warehouse` (string)
    See [warehouse locations](../../../../docs/codes/warehouselocations) for possible values.
    Enum: "APC01", "APC02", "COB01", "COB02", "ETC01", "MMC01", "PRB02", "PRB04", "SJU01", "TWL01", "VCX01", "WOX01"

  - `Warehouses` (array)
    (COMING SOON)
    Enum: "APC01", "APC02", "COB01", "COB02", "ETC01", "MMC01", "PRB02", "PRB04", "SJU01", "TWL01", "VCX01", "WOX01"

  - `Reference` (string)
    This field contains [Inventory Transaction Reference Codes](https://developer.wineshipping.com/../../../../docs/v3/ZG9jOjE4NTY4NjU2-codes-and-descriptions#inventory-transaction-reference-codes) that explain why a transaction occurred

  - `InventoryStatus` (string)
    See [inventory codes](../../../../docs/codes/inventorycodes) for possible values.

Array of up to 5 items is allowed, and if omitted, all items will be included in the results.
    Enum: "GOOD-NO-BD", "GOOD-NO-TX", "GOOD-ST-BD", "GOOD-ST-EX", "GOOD-ST-IM", "GOOD-ST-TX", "RTGD-NO-TX", "CDMG-NO-TX", "DMGD-NO-TX"

  - `InventoryStatuses` (array)
    (COMING SOON)
    Enum: "GOOD-NO-BD", "GOOD-NO-TX", "GOOD-ST-BD", "GOOD-ST-EX", "GOOD-ST-IM", "GOOD-ST-TX", "RTGD-NO-TX", "CDMG-NO-TX", "DMGD-NO-TX"

  - `ItemNumbers` (array)

  - `Skip` (integer)

  - `Top` (integer)

## Response 200 fields (application/json):

  - `TransactionReferenceNumber` (string)

  - `TotalRecordCount` (integer)

  - `Skip` (integer)

  - `Top` (integer)

  - `MoreRecords` (boolean)

  - `InventoryTransactions` (array)

  - `InventoryTransactions.ItemNo` (string)

  - `InventoryTransactions.ItemDescription` (string)

  - `InventoryTransactions.ItemUnit` (string)

  - `InventoryTransactions.AlcoholPercentage` (string)

  - `InventoryTransactions.Warehouse` (string)

  - `InventoryTransactions.InventoryStatus` (string)

  - `InventoryTransactions.TransactionDate` (string)
    Example: "1/1/2025"

  - `InventoryTransactions.TransactionDateTime` (string)
    (COMING SOON)
    Example: "2025-01-01T08:12:39.483Z"

  - `InventoryTransactions.TransactionType` (string)

  - `InventoryTransactions.Reference` (string)

  - `InventoryTransactions.PONumber` (string)

  - `InventoryTransactions.ShipToName` (string)

  - `InventoryTransactions.OrderType` (string)

  - `InventoryTransactions.Quantity` (integer)