Guides
My Account
  1. Ship with Walmart
  2. Ship with Walmart

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-date

Function

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 center
  • maxShipOnDate: Maximum date allowed for shipping
  • allowedShipDates: 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 purchases and generates a shipping label for Walmart Marketplace orders.

The Shipping estimates API provides shipping costs for carriers.

The Labels detail by purchase order ID API retrieves the status and details of existing shipping labels.

The Supported carriers API provides a list of Walmart approved carriers for shipping orders.

The Download label API removes the shipping label and cancels the shipping with the carrier..

The Discard label API removes a shipping label and then cancels it with the carrier.

The Supported carrier package types API provides the different package types available for a carrier.