Get ship-on-date
Walmart’s Get ship-on-date API provides recommendations for the default ship-on-date and maximum ship-on-date for seller orders.
Endpoint
GET /v3/shipping/ship-nodes/{shipNodeId}/ship-on-dateFunction
This API is used to:
- Retrieve default ship-on dates
- Find ship-on dates allowed
- Validate shipping plans
- 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.
Request sample
curl --request GET \ --url https://marketplace.walmartapis.com/v3/shipping/ship-nodes/shipNodeId/ship-on-date \ --header 'accept: application/json' Modify your code
Use the ship node (fulfillment center) ID in the request path to query the shipping window.
- Keep the accept: application/json header to receive the JSON output.
- Use the response values to determine whether your ship date falls within the allowed shipping window.
Response samples
200 Response application/json sample code
{ "data": { "defaultShipOnDate": "03/24/2026", "maxShipOnDate": "03/26/2026", "allowedShipDates": [ { "date": "03/24/2026", "cutoffTime": "23:59" } ] } } 400 Response application/problem+json sample code
{ "type": "https://marketplace.walmart.com/errors/invalid-ship-date", "title": "Invalid Ship Date", "status": 400, "detail": "Input date format is incorrect. Expected MM/dd/yyyy.", "instance": "/v3/shipping/ship-nodes/NODE-001/ship-on-date", "code": "LS-4010" } 500 Response application/problem+json sample code
{ "type": "https://marketplace.walmart.com/errors/internal-server-error", "title": "Internal Server Error", "status": 500, "detail": "We are unable to retrieve ship-on-date due to a technical issue. Please try again shortly. If the issue persists, please try an alternative way to ship this order.", "instance": "/v3/shipping/ship-nodes/NODE-001/ship-on-date", "code": "LS-5010" } Result
A successful response returns:
defaultShipOnDate: Standard ship-on date for the fulfillment centermaxShipOnDate: Maximum date allowed for shippingallowedShipDates: Valid ship dates and cutoff times
Response errors indicate:
- 400 bad request: The ship date format or input is invalid
- 500 internal server error: The service cannot retrieve ship-on-date data due to a technical issue
Next Steps
The Create label API lets you buy labels from Walmart to ship orders.
The Shipping estimates API provides the best rate to ship an order.
The Label details by purchase order ID API procures shipping label information on multiple orders such as label generation, carrier service type, shipment tracking, shipment protection, and signature protection.
The Supported carriers API provides a list of Walmart's approved carriers to ship orders.
The Download label API retrieves a carrier label by the carrier and tracking number.
The Discard label API removes shipping labels.
The Supported carrier package types API provides package types the carrier offers.
The Create scan form for labels API creates a scan form (also called a shipping manifest) to group multiple labels together for a carrier to scan a single document at pickup.
The Download scan form API downloads a scan form document from the manifestId.
Updated 1 day ago