Choose an Orders API

The Walmart Marketplace Orders API provides several endpoints to help you manage the full lifecycle of an order. These APIs can be grouped in the following workflow:

  1. Retrieve orders
    Fetch lists of orders and view detailed order information.
  2. Acknowledge orders
    Confirm that you’ve received an order and plan to fulfill it.
  3. Shipping, cancellations, and refunds
    Once the order is acknowledged, you can update shipping details, or take corrective actions like canceling or refunding order lines.

Retrieve orders

Call these endpoints to fetch order lists and view order details. You can also use them to monitor order statuses and gather information needed for fulfillment.

Learn more about retrieving orders use cases.

Acknowledge orders

Call this endpoint to confirm you’ve received the order and intend to fulfill it. This is a required step before shipping.

Learn more about acknowledging and shipping orders use cases.

Shipping, cancellations, and refunds

Call these endpoints after acknowledging the order. You can mark items as shipped, cancel unfulfillable lines, or issue refunds.

Learn more about cancellations and refunds use cases.