# Get package shipping details

This operation provides package information in batches once warehouse activity started in order fulfillment. Provides filters options to search for packages by ship date range, last activity date range, shipping carrier, order numbers and options to paginate through the result set.

Please also see our event-based API:
event driven tracking 

Endpoint: POST /api/Tracking/GetPackages
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"

  - `ShipDateRange` (string)

  - `LastActivityDateRange` (string)
    When populating this string, it is important to specify both date and time as shown in the example below. If you are searching for a single date, you will still need to provide the range with a time value to capture all activity within a 24-hour period. Example: "12/19/2025 00:00:00 - 12/19/2025 23:59:59"
    Example: "\"01/01/2025 00:00:00 - 12/31/2025 23:59:59\""

  - `ShippingCarrier` (string)

  - `OrderNumbers` (array)
    Array of up to 100 order numbers is allowed

  - `Skip` (number)

  - `Top` (number)

## Response 200 fields (application/json):

  - `TransactionReferenceNumber` (string)
    Example: "8a806bdb-49ee-4465-86a1-fa10e47d22a1"

  - ` LatestActivityTimestamp` (string)
    LastActivityTimestamp field represents the latest timestamp from the filtered timeframe. If no data is returned, it returns the latest timestamp in our dataset preceding the timeframe.
    Example: "01/01/2025 21:09:53"

  - `TotalRecordCount` (integer)
    Example: 1

  - `Skip` (integer)

  - `Top` (integer)
    Example: 500

  - `MoreRecords` (boolean)

  - `Packages` (array)

  - `Packages.OrderNumber` (string)
    Example: "08312021-FO-9808"

  - `Packages.Carrier` (string)
    Carrier Code used to ship the order
    Example: "FEX"

  - `Packages.Service` (string)
    Code of the carrier service level used to ship the order
    Example: "GRND"

  - `Packages.TrackingNo` (string)
    Tracking number for the package
    Example: "934076697393"

  - `Packages.TrackingURL` (string)
    hyperlink for carrier package tracking (when available from the carrier)
    Example: "https://www.fedex.com/apps/fedextrack/?tracknumbers=934076697393"

  - `Packages.RequestedShipDate` (string)
    The requested shipping date specified upon order creation in the Wineshipping system and updated dynamically based on the order processing status.

  - `Packages.ShipDate` (string)
    Requested ship date submitted with the sales order until the package is processed for shipment and receives a shipment confirmation date (actual ship date)

  - `Packages.EstimatedDeliveryDate` (string)
    Upon Sales Order processing, this is the Estimated Delivery Date for the Sales Order based on the Requested Shipping Date submitted, and it will update within 4 hours of any changes made to the Sales Order’s Requested Shipping date. Upon origin scan for each package, this date will be representative of the carrier’s published estimate. Support is presently for FEX and UPS carriers.

  - `Packages.Status` (string)
    See package [fulfillment status codes](../../../../docs/codes/fulfillmentstatuscodes) for possible values.

  - `Packages.StatusDescription` (string)
    See package [fulfillment status descriptions](../../../../docs/codes/fulfillmentstatuscodes) for possible values.
    Example: "Package delivered to the receiver"

  - `Packages.Type` (string)
    Order type - Club, Daily, or other as applicable
    Example: "CLUB"

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

  - `Packages.CarrierStatus` (string)
    Current carrier status code
    Example: "D"

  - `Packages.CarrierStatusMessage` (string)
    Status message directly from the carrier
    Example: "Delivered"

  - `Packages.CarrierStatusTimestamp` (string)

  - `Packages.PackageLocation` (string)

  - `Packages.GrossWeight` (string)
    Gross package weight in lbs
    Example: "22.6"

  - `Packages.ShipToName` (string)
    Ship to name or company name
    Example: "Jane Doe"

  - `Packages.ShipToContact` (string)
    Ship to contact person name

  - `Packages.ShipToAddress` (string)
    Primary address where the package is shipped
    Example: "3010 Main Street"

  - `Packages.ShipToAddress2` (string)
    Second address line where the package is shipped

  - `Packages.ShipToCity` (string)
    Example: "Folsom"

  - `Packages.ShipToState` (string)
    Example: "CA"

  - `Packages.ShipToZipCode` (string)
    Example: "95630"

  - `Packages.ShipToCountry` (string)
    Example: "USA"

  - `Packages.PackageItems` (array)
    Items in the Package

  - `Packages.PackageItems.ItemNo` (string)
    Example: "1000000001"

  - `Packages.PackageItems.Quantity` (string)
    Example: "6.00"

  - `Packages.PackageItems.ReservedQuantity` (string)
    Example: "6.00"

  - `Packages.PackageItems.ItemDescription` (string)
    Example: "2018 CAB FRANC NV"