My Account

New: Get ship-on-date API

Date: July 1, 2026

The Walmart Ship With Walmart API now supports a new Get ship-on-date endpoint. This Get ship-on-date endpoint has default ship-on-date and max ship-on-date functionality. This API returns the default ship-on date, maximum ship-on date, allowed ship dates, and cutoff times for a fulfillment center.

Use this API to confirm the shipping window for orders at your fulfillment center before creating a shipping label.

What changed

  • Added the new Ship With Walmart endpoint: GET v3/shipping/ship-nodes/{shipNodeId}/ship-on-date
  • The API returns ship-on-date recommendations for your fulfillment center.
  • The response includes:
    • defaultShipOnDate: The standard ship-on date for your fulfillment center
    • maxShipOnDate: The latest allowable ship-on date.
    • allowedShipDates: The ship dates and cutoff times

Why it matters

The new API:

  • Helps you choose a valid ship-on date before buying a label.
  • Reduces shipping plan errors by providing the allowed shipping window.
  • Supports more accurate label creation and shipping fee estimates.
  • Helps validate ship dates before you submit your shipment request.
  • Get ship-on-dates: The Get-ship-on-date API calculates the allowable window of time an order can be shipped and handed off to a carrier to meet the delivery promise. The ship-on-date is used to determine the Shipping estimates for carriers.
  • Determine the maximum ship-on-date: When a seller buys a label using Ship With Walmart, this is the maximum date by which the package must be handed over to the carrier. This date is calculated by entering the estimated shipping date (ESD) when the seller hands off the order to the carrier, plus two days. ESDs for orders which exceed the maximum-ship-on-date will not receive Ship With Walmart protections such as insurance for lost or stolen orders.

Next steps

  • Update your integration to call the Get default and max ship-on-date API before label creation.
  • The seller must specify the estimated ship date as a value in the query parameter.
  • Replace {shipNodeId} in the request path with the ship node ID for the fulfillment center.
  • Keep the accept application/json header in your request.
  • Use defaultShipOnDate, maxShipOnDate, and allowedShipDates to confirm that the ship date is valid.
  • Review error handling for 400 and 500 responses.