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 --request GET \ --url 'https://marketplace.walmartapis.com/v3/orders?limit=100&productInfo=false&shipNodeType=SellerFulfilled&replacementInfo=false&incentiveInfo=false' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6' \ --header 'WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....' \ --header 'WM_SVC.NAME: Walmart Marketplace’ \

import requests url = "https://marketplace.walmartapis.com/v3/orders"
params = { "limit": 100, "productInfo": "false", "shipNodeType": "SellerFulfilled", "replacementInfo": "false", "incentiveInfo": "false",
}
headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_QOS.CORRELATION_ID": "b3261d2d-028a-4ef7-8602-633c23200af6", "WM_SEC.ACCESS_TOKEN": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....", "WM_SVC.NAME": "Walmart Marketplace",
} r = requests.get(url, headers=headers, params=params)
print(r.json())

Modify your code

Use a unique WM_QOS.CORRELATION_ID for each request.
Replace WM_SEC.ACCESS_TOKEN with your valid access token obtained through authentication.

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.

Updated 6 days ago