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

application/json

200 Sample 1

{ "data": { "defaultShipOnDate": "03/24/2026", "maxShipOnDate": "03/26/2026", "allowedShipDates": [ { "date": "03/24/2026", "cutoffTime": "23:59" } ] }
}

application/problem+json

400 invalidShipDate

{ "type": "https://marketplace.walmart.com/errors/invalid-ship-date", "title": "Invalid ship date", "status": 400, "detail": "The input date format is incorrect. The expected date format is MM/DD/YYYY.", "instance": "/v3/shipping/ship-nodes/NODE-001/ship-on-date", "code": "LS-4010"
}

401 Unauthorized

{ "type": "https://marketplace.walmart.com/errors/unauthorized", "title": "Unauthorized", "status": 401, "detail": "Invalid or missing the bearer token.", "instance": "/v3/shipping/ship-nodes/NODE-001/ship-on-date", "code": "LS-4011"
}

403 Forbidden

{ "type": "https://marketplace.walmart.com/errors/forbidden", "title": "Forbidden", "status": 403, "detail": "You do not have permission to access this ship node.", "instance": "/v3/shipping/ship-nodes/NODE-001/ship-on-date", "code": "LS-4013"
}

404 shipNodeNotFound

{ "type": "https://marketplace.walmart.com/errors/ship-node-not-found", "title": "Ship node not found", "status": 404, "detail": "The specified ship node was not found.", "instance": "/v3/shipping/ship-nodes/NODE-001/ship-on-date", "code": "LS-4014"

500 upstreamFailure

{ "type": "https://marketplace.walmart.com/errors/internal-server-error", "title": "Internal server error", "status": 500, "detail": "We are unable to retrieve the ship-on date due to a technical issue. Retry shortly. If the issue persists, use an alternative method 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 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 about 1 month ago

Did this page help you?