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 \ --header 'WM_GLOBAL_VERSION: 3.1' \ --header 'WM_MARKET: us' \ --header 'WM_QOS.CORRELATION_ID: 1234567890' \ --header 'WM_SEC.ACCESS_TOKEN: eyJraWQiOiIredacted.....' \ --header 'WM_SVC.NAME: Walmart Marketplace' \ --header 'accept: application/json'

import requests url = "https://marketplace.walmartapis.com/v3/orders"
params = { "limit": 100, "productInfo": "false", "shipNodeType": "SellerFulfilled", "replacementInfo": "false"
} headers = { "WM_SEC.ACCESS_TOKEN": "eyJraWQiOiIredacted.....", "WM_GLOBAL_VERSION": "3.1", "WM_MARKET": "us", "WM_QOS.CORRELATION_ID": "1234567890", "WM_SVC.NAME": "Walmart Marketplace", "Accept": "application/json"
} response = requests.get(url, headers=headers, params=params)
print(response.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 }, "miscAttributes": { "miscAttribute": [ { "name": "PET_DETAILS", "details": { "detail": [ { "key": "PET_FIRST_NAME", "value": "Blue" }, { "key": "PET_LAST_NAME", "value": "Scarano" } ] } } ] } } ] } } ] } }
}

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.