Get all orders

Call this endpoint to retrieve all orders for your account. You can use this endpoint to get a list of orders, their statuses, customer details, and fulfillment information.

Note: Only orders from the last 180 days are available and you can fetch up to 10,000 orders at a time. If you try to get more than 10,000 orders, the API will return an error.

Note: This page describes an example using only some common parameters and inputs for getting all orders. For a full list of customization options and additional capabilities, refer to the Walmart Orders API Reference.

Endpoint

GET https://marketplace.walmartapis.com/v3/orders

Sample request

This example shows you how to set the required headers, including your Base64-encoded credentials and a unique correlation ID, and how to structure your API call to retrieve all orders from your account. Use this sample as a starting point, then modify it with your actual values and any additional parameters described in the API reference.

curl -X GET "https://marketplace.walmartapis.com/v3/orders?limit=100&productInfo=false&shipNodeType=SellerFulfilled&replacementInfo=false" \ -H "Authorization: Basic <Base64EncodedClientID:ClientSecret>" \ -H "WM_SVC.NAME: Walmart Marketplace" \ -H "WM_QOS.CORRELATION_ID: 1234567890" \ -H "Accept: application/json" \ -H "Content-Type: application/json"

import requests url = "https://marketplace.walmartapis.com/v3/orders" headers = { "Authorization": "Basic <Base64EncodedClientID:ClientSecret>", "WM_SVC.NAME": "Walmart Marketplace", "WM_QOS.CORRELATION_ID": "1234567890", "Accept": "application/json", "Content-Type": "application/json"
} response = requests.get(url, headers=headers)
print(response.json())

Modify your code

Replace <Base64EncodedClientID:ClientSecret> with your Base64-encoded client credentials.
Update WM_QOS.CORRELATION_ID for your request tracking.

Sample response

{ "list": { "meta": { "totalCount": 31, "limit": 10, "nextCursor": "?limit=10&hasMoreElements=true&soIndex=31&poIndex=10&partnerId=ABCDEF&sellerId=0123456&createdStartDate=YYYY-MM-DD&createdEndDate=YYYY-MM-DDTHH:MM:SS.sssZ" }, "elements": { "order": [ { "purchaseOrderId": "0123456789", "customerOrderId": "ABCDEFGHIJ", "customerEmailId": "[email protected]", "orderType": "REPLACEMENT", "originalCustomerOrderID": "KLMNOPQRST", "orderDate": 1568466571000, "shippingInfo": { "phone": "0123456789", "estimatedDeliveryDate": 1569438000000, "estimatedShipDate": 1568700000000, "methodCode": "Value", "postalAddress": { "name": "John Doe", "address1": "1234 Example Rd", "address2": "Suite 100", "city": "Example City", "state": "EX", "postalCode": "12345", "country": "USA", "addressType": "RESIDENTIAL" } }, "orderLines": { "orderLine": [ { "lineNumber": "1", "item": { "productName": "Example Product", "sku": "SKU01234" }, "charges": { "charge": [ { "chargeType": "PRODUCT", "chargeName": "ItemPrice", "chargeAmount": { "currency": "USD", "amount": 10 }, "tax": { "taxName": "Tax1", "taxAmount": { "currency": "USD", "amount": 0.8 } } } ] }, "orderLineQuantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "statusDate": 1568466647000, "orderLineStatuses": { "orderLineStatus": [ { "status": "Created", "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "1" } } ] }, "fulfillment": { "fulfillmentOption": "S2H", "shipMethod": "VALUE", "pickUpDateTime": 1568919600000 } } ] } } ] } }
}

Result

If successful, the API responds with an HTTP status: 200 OK and a JSON payload containing a list of purchase orders with their details.

Next step

Retrieve all orders with line items in the Created status that Walmart has released for processing.