# Get returns

Use this operation to retrieve a list of return sales orders for a customer. Successful execution of this method will generate a list of returns from Wineshipping system.

Endpoint: POST /api/SalesOrder/GetReturns
Version: 3.1.3

## Request fields (application/json):

  - `Authentication` (object)
    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"

  - `OrderNumbers` (array)
    Array of up to 100 order numbers is allowed
    Example: ["AQA_ICN82DP4UC"]

  - `StartTime` (string)
    Example: "2026-01-01T15:58:52.526Z"

  - `EndTime` (string)
    Example: "2026-01-01T15:58:52.526Z"

  - `DispositionCode` (string)
    Enum: "Return to Winery", "Reship", "Return to Inventory"

  - `Warehouse` (string)
    Enum: "APC01", "APC02", "COB01", "COB02", "ETC01", "MMC01", "PRB02", "PRB04", "SJU01", "TWL01", "VCX01", "WOX01"

  - `IncludeTotalRecordCount` (boolean)
    Example: true

  - `Skip` (integer)

  - `Top` (integer)

## Response 200 fields (application/json):

  - `TotalRecordCount` (integer)

  - `Skip` (integer)

  - `Top` (integer)

  - `MoreRecords` (boolean)

  - `ReturnSalesOrderHeaders` (array)

  - `ReturnSalesOrderHeaders.CustomerNo` (string)

  - `ReturnSalesOrderHeaders.CustomerName` (string)

  - `ReturnSalesOrderHeaders.RMANumber` (string)

  - `ReturnSalesOrderHeaders.OrderNo` (string)

  - `ReturnSalesOrderHeaders.ReceivedDate` (string)

  - `ReturnSalesOrderHeaders.CloseDate` (string)

  - `ReturnSalesOrderHeaders.ShipToName` (string)

  - `ReturnSalesOrderHeaders.ShipToCompany` (string)

  - `ReturnSalesOrderHeaders.ShipToAddress` (string)

  - `ReturnSalesOrderHeaders.ShipToAddress2` (string)

  - `ReturnSalesOrderHeaders.ShipToCity` (string)

  - `ReturnSalesOrderHeaders.ShipToState` (string)

  - `ReturnSalesOrderHeaders.ShipToZipCode` (string)

  - `ReturnSalesOrderHeaders.ShipToCountry` (string)

  - `ReturnSalesOrderHeaders.EmailAddress` (string)

  - `ReturnSalesOrderHeaders.PhoneNumber` (string)

  - `ReturnSalesOrderHeaders.ReturnWarehouse` (string)

  - `ReturnSalesOrderHeaders.ReturnStatus` (string)

  - `ReturnSalesOrderHeaders.DispositionCode` (string)

  - `ReturnSalesOrderHeaders.ReturnReason` (string)

  - `ReturnSalesOrderHeaders.OriginalTrackingNumber` (string)

  - `ReturnSalesOrderHeaders.ShippingCarrierCode` (string)

  - `ReturnSalesOrderHeaders.ShippngServiceCode` (string)

  - `ReturnSalesOrderHeaders.ReturnSalesOrderLines` (array)

  - `ReturnSalesOrderHeaders.ReturnSalesOrderLines.ItemNo` (string)

  - `ReturnSalesOrderHeaders.ReturnSalesOrderLines.ItemDescription` (string)

  - `ReturnSalesOrderHeaders.ReturnSalesOrderLines.Quantity` (string)

  - `ReturnSalesOrderHeaders.ReturnSalesOrderLines.UOM` (string)

  - `ReturnSalesOrderHeaders.ReturnSalesOrderLines.DispositionCode` (string)

  - `ReturnSalesOrderHeaders.ReturnSalesOrderLines.InventoryStatusCode` (string)


## Response 400 fields

## Response 401 fields

## Response 429 fields

## Response 500 fields