Get all released orders

Call this endpoint to retrieve all orders with line items in the Created status that Walmart has released for processing. Released orders are ready for you to pick, pack, and ship. By default, only seller-fulfilled orders are returned. To include orders with shipNodeType values such as WFSFulfilled or 3PLFulfilled, specify the parameter when querying.

Note:

Only orders created in last 180 days and a maximum of 10,000 orders can be fetched at a time. Attempting to download more than 10,000 orders will return an error.

Walmart Fulfillment Services (WFS) orders are automatically moved to the Acknowledged status and will not appear in this response. Use the GET All Orders or GET An Order API to retrieve WFS orders.

Note: This page describes an example using only the required parameters and inputs for getting all released 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/released

Sample request

curl -X GET "https://marketplace.walmartapis.com/v3/orders/released?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/released" 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 with a unique value to track your request.
• Optionally, include the shipNodeType parameter to fetch orders with specific fulfillment types.

Sample response

{ "list": { "meta": { "totalCount": 12345, "limit": 10, "nextCursor": "?limit=10&hasMoreElements=true&soIndex=12345&poIndex=10&partnerId=ABCDEF&sellerId=0123456&status=Created&createdStartDate=YYYY-MM-DD&createdEndDate=YYYY-MM-DDTHH:MM:SS.sssZ" }, "elements": { "order": [ { "purchaseOrderId": "PO123456789", "customerOrderId": "CO123456789", "customerEmailId": "[email protected]", "orderType": "REPLACEMENT", "originalCustomerOrderID": "OC123456789", "orderDate": 1571903550000, "shippingInfo": { "phone": "0123456789", "estimatedDeliveryDate": 1572375600000, "estimatedShipDate": 1572069600000, "methodCode": "Express", "postalAddress": { "name": "John Doe", "address1": "1234 Example Rd", "city": "ExampleCity", "state": "EX", "postalCode": "12345", "country": "USA", "addressType": "RESIDENTIAL" } }, "orderLines": { "orderLine": [ { "lineNumber": "3", "item": { "productName": "Example Product 29", "sku": "SKU29" }, "charges": { "charge": [ { "chargeType": "PRODUCT", "chargeName": "ItemPrice", "chargeAmount": { "currency": "USD", "amount": 99 }, "tax": { "taxName": "Tax1", "taxAmount": { "currency": "USD", "amount": 7.92 } } }, { "chargeType": "SHIPPING", "chargeName": "Shipping", "chargeAmount": { "currency": "USD", "amount": 60 } } ] }, "orderLineQuantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "statusDate": 1571903748000, "orderLineStatuses": { "orderLineStatus": [ { "status": "Created", "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "1" } } ] }, "fulfillment": { "fulfillmentOption": "S2H", "shipMethod": "EXPEDITED", "pickUpDateTime": 1572289200000 } } ] }, "shipNode": {} }, { "purchaseOrderId": "PO987654321", "customerOrderId": "CO987654321", "customerEmailId": "[email protected]", "orderType": "REGULAR", "orderDate": 1571903539000, "shippingInfo": { "phone": "0123456789", "estimatedDeliveryDate": 1572375600000, "estimatedShipDate": 1572069600000, "methodCode": "Express", "postalAddress": { "name": "Jane Doe", "address1": "2200 Example Ln", "city": "ExampleCity", "state": "EX", "postalCode": "67890", "country": "USA", "addressType": "RESIDENTIAL" } }, "orderLines": { "orderLine": [ { "lineNumber": "11", "item": { "productName": "Example Product 55", "sku": "SKU55" }, "charges": { "charge": [ { "chargeType": "PRODUCT", "chargeName": "ItemPrice", "chargeAmount": { "currency": "USD", "amount": 99 } }, { "chargeType": "SHIPPING", "chargeName": "Shipping", "chargeAmount": { "currency": "USD", "amount": 60 } } ] }, "orderLineQuantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "statusDate": 1571903763000, "orderLineStatuses": { "orderLineStatus": [ { "status": "Created", "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "1" } } ] }, "fulfillment": { "fulfillmentOption": "S2H", "shipMethod": "EXPEDITED", "pickUpDateTime": 1572289200000 } } ] }, "shipNode": {} } // Additional orders... ] } }, "errors": []
}

Result

If successful, the API returns an HTTP status: 200 OK along with a JSON payload. This payload contains a list object that includes metadata about the results (such as count) and the elements array with detailed purchase order information in the Created state. Any errors encountered during the request are returned in the errors array.

Next step

Retrieve detailed information about a specific order.