# Get orders on hold

Use this operation to retrieve a list of on-hold orders for a customer. Successful execution of this method will generate a list of on hold orders from Wineshipping's system and if no orders are on hold, HTTP status code Not Found response will be returned.

Endpoint: POST /api/SalesOrder/GetOrdersOnHold
Version: 3.1.3
Security: Authentication

## Request fields (application/json):

  - `UserKey` (string, required)

  - `Password` (string, required)

  - `CustomerNo` (string, required)

## Response 200 fields (application/json):

  - `CustomerNo` (string)

  - `CustomerName` (string)

  - `OrderNo` (string)

  - `OrderType` (string)

  - `OrderDate` (string)

  - `ShipmentDate` (string)

  - `ShippingSite` (string)

  - `ShippingWarehouse` (string)

  - `HoldReason` (string)

  - `HoldReasonDescription` (string)
    A description of the reason your order is on hold and if it requires action.

  - `ShippingCarrier` (string)

  - `ShippingCarrierService` (string)

  - `OrderOnHoldItems` (array)

  - `OrderOnHoldItems.ItemNo` (string)

  - `OrderOnHoldItems.Quantity` (string)

  - `OrderOnHoldItems.ItemDescription` (string)

  - `OrderOnHoldItems.QuantityReserved` (string)
    The inventory allocation already available to incoming orders.

  - `OrderOnHoldItems.IncomingPreReserved` (number)
    The number of items on an order reserved against incoming purchase orders that will be fulfilled once they arrive at the warehouse.

  - `OrderOnHoldItems.Oversold` (number)
    Oversold is the number of items on an order that cannot be fulfilled based on current and incoming inventory. Orders that contain these items cannot be fulfilled until more inventory is available.