Call this endpoint to retrieve a paginated list of Walmart Multichannel Solutions (MCS) customer fulfillment orders including each order's current processing status and key details. You can retrieve the order details such as ship node, status, order channel ID, and date of order creation. You can also retrieve line details, which include status, shipping method, and fulfillment type.

The API can respond with more information on multiple orders based on query parameters like order created date (startDate and endDate), status, shipNumber, and orderChannelId. If you pass only the orderNumber, the API returns details of that specific order.

Endpoint

GET https://marketplace.walmartapis.com/v3/fulfillment/orders-fulfillments/statu

Request

This sample request filter orders by date window and status. In addition, you can also filter by channel or ship node.

curl --request GET \ --url 'https://marketplace.walmartapis.com/v3/fulfillment/orders-fulfillments/status?startDate=2025-07-01T00:00:00Z&endDate=2025-07-31T23:59:59Z&status=SHIPPED&orderChannelId=MYACCOUNT&shipNumber=1234' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --header 'WM_SEC.ACCESS_TOKEN: <your_oauth_access_token>' \ --header 'WM_SVC.NAME: Walmart Marketplace' \ --header 'WM_QOS.CORRELATION_ID: <uuid-for-this-call>'

import requests url = "https://marketplace.walmartapis.com/v3/fulfillment/orders-fulfillments/status" headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "<your_oauth_access_token>", "WM_SVC.NAME": "Walmart Marketplace", "WM_QOS.CORRELATION_ID": "<uuid-for-this-call>",
} params = { "startDate": "2025-07-01T00:00:00Z", "endDate": "2025-07-31T23:59:59Z", "status": "SHIPPED", "orderChannelId": "MYACCOUNT", "shipNumber": "1234",
} response = requests.get(url, headers=headers, params=params)
print(response.status_code)
print(response.text)

This sample request filters a single order by orderNumber.

curl --request GET \ --url 'https://marketplace.walmartapis.com/v3/fulfillment/orders-fulfillments/status?orderNumber=RAPMOCK1719065835761' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --header 'WM_SEC.ACCESS_TOKEN: <your_oauth_access_token>' \ --header 'WM_SVC.NAME: Walmart Marketplace' \ --header 'WM_QOS.CORRELATION_ID: <uuid-for-this-call>'

import requests url = "https://marketplace.walmartapis.com/v3/fulfillment/orders-fulfillments/status" headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "<your_oauth_access_token>", "WM_SVC.NAME": "Walmart Marketplace", "WM_QOS.CORRELATION_ID": "<uuid-for-this-call>",
} params = { "orderNumber": "RAPMOCK1719065835761",
} response = requests.get(url, headers=headers, params=params)
print(response.status_code)
print(response.text)

Response

The following is a sample successful response provided by the API.

{ "status": "OK", "header": { "headerAttributes": { "buId": "0", "martId": "202", "pageCount": 1, "totalCount": 1 } }, "payload": [ { "sellerOrderId": "ptrn20802", "orderType": "DOMESTIC", "status": "DELIVERED", "orderDate": "2022-12-31T21:57:51.176Z", "buyerInfo": { "primaryContact": { "name": { "firstName": "First name", "lastName": "Last name" } } }, "shipments": [ { "status": "DELIVERED", "statusDescription": "Shipment Delivered", "purchaseOrderId": "2873667778063", "scac": "Fedex", "trackingNo": "626969279882", "externalTrackingURL": "https://www.walmart.com/orders/ptrn20802/track/626969279882", "shipmentNo": "db1e8da5-fa38-4074-a4d4-9f5da430d4dd", "actualShipmentDate": "2023-01-02T15:51:22.000Z", "packageASN": "55558952333141953386", "carrierDescription": "Fedex", "carrierServiceCode": "7610", "packageId": "55558952333141953386", "lastModified": "2023-01-05T19:38:27.950Z", "shipmentLines": [ { "shipmentLineNo": "7101212", "fulfillerLineId": "1", "quantity": { "unitOfMeasure": "EA", "measurementValue": 1 } } ], "shipmentDates": [ { "actualDate": "2023-01-02T15:51:22.000Z", "dateTypeId": "SHIPMENT", "expectedDate": "2023-01-02T18:45:00.000Z" }, { "dateTypeId": "OPD", "expectedDate": "2023-01-03T04:57:00.000Z" }, { "actualDate": "2023-01-05T19:29:00.000Z", "dateTypeId": "DELIVERY", "expectedDate": "2023-01-05T20:00:00.000Z" } ] } ], "orderLines": [ { "fulfillmentType": "DELIVERY", "lastModified": "2022-12-31T21:57:52.529Z", "shippingMethod": "STANDARD", "shippingTier": "TWO_DAY", "orderLineQuantityInfo": [ { "status": "PROCESSING", "statusDescription": "SUCCESSFULLY_SOURCED", "statusQuantity": { "unitOfMeasure": "EA", "measurementValue": 1 } } ], "orderProduct": { "productName": "London Fog - Missy Sb Double Collar - Black - Large" }, "orderedQty": { "unitOfMeasure": "EA", "measurementValue": 1 }, "shipToAddress": { "address": { "addressLineOne": "Address line one", "addressLineTwo": "Address line 2", "addressType": "RESIDENTIAL", "city": "Ontario", "countryCode": "US", "postalCode": "12345", "stateOrProvinceName": "CA", "stateOrProvinceCode": "CA" }, "name": { "completeName": "Firstname lastname", "firstName": "Firstname", "lastName": "Lastname" } } } ] } ]
}

The following is a sample response provided by the API on failures. The description and information might change based on the error.

{ "status": "FAIL", "errors": [ { "code": "ERR_EXT_DATA_0021001", "description": "The payload structure is not valid. Please correct the payload.", "info": "[Error [code=DATA, field=400.WSAAS.106, description=limit should be greater than 0 or less than equal to 50, info=Provided value is not allowed, severity=ERROR, category=REQUEST, causes=null]]", "severity": "ERROR", "category": "REQUEST" } ]
}

Result

If successful, the API returns 200 OK with a JSON body that includes a header object containing totalCount and pageCount, and pagination cursors when applicable.