Fulfill with WFS recommendations

Call this endpoint to identify which seller-fulfilled items in your catalog Walmart suggests could potentially perform best when fulfilled by WFS. These suggestions are available on demand, and suggestions are refreshed the 1st and 15th of each month.

Key attributes include:

estimatedSalesLift: The estimated increase in sales you could see if you converted the suggested items from seller-fulfilled to WFS.
sellerFulfilledPast30DaysSales: A historical view of your seller-fulfilled sales for the past 30 days.
sellerFulfilledGMV: What you currently earn from seller-fulfilled items, based on your sales from the past 30 days.
walmartFulfilledEstimatedSales: An estimated view of your potential sales if the suggested items were fulfilled by WFS.

You can use these suggestions to determine which items to convert to WFS.

This page describes an example using only the required parameters and inputs for retrieving items recommended to convert to WFS. For a full list of customization options and additional capabilities, refer to the Walmart Recommendations API Reference.

Endpoint

GET https://marketplace.walmartapis.com/v3/wfs/recommendation/convert

Retrieve fulfill with WFS recommendations

Sample request

Use this sample request to retrieve a paginated list of items that Walmart recommends converting to WFS (Walmart Fulfillment Services).

curl "https://marketplace.walmartapis.com/v3/wfs/recommendation/convert?showInsights=true&limit=10&offset=0&sort_order=DESC&sort_by=vendorSku" \ -H "WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6" \ -H "WM_MARKET: US" \ -H "WM_SVC.NAME: Walmart Marketplace" \ -H "WM_SEC.ACCESS_TOKEN: <REDACTED>" \ -H "WM_GLOBAL_VERSION: 3.1" \ -H "Accept: application/json"

import requests url = "https://marketplace.walmartapis.com/v3/wfs/recommendation/convert"
params = { "showInsights": "true", "limit": "10", "offset": "0", "sort_order": "DESC", "sort_by": "vendorSku",
}
headers = { "WM_QOS.CORRELATION_ID": "b3261d2d-028a-4ef7-8602-633c23200af6", "WM_MARKET": "US", "WM_SVC.NAME": "Walmart Marketplace", "WM_SEC.ACCESS_TOKEN": "<ACCESS_TOKEN>", "WM_GLOBAL_VERSION": "3.1", "Accept": "application/json",
} response = requests.get(url, headers=headers, params=params, timeout=30)
response.raise_for_status()
print(response.json())

Sample response

{ "status": "OK", "payload": { "recommendedItems": [ { "gtin": "00951898895998", "sku": "JQWSQ30BFXDGXM001V0621", "itemId": "3386183152", "brand": "BENTISM", "itemName": "BENTISM Galvanized Poultry Feeder Chicken Feeder No Waste 30 lbs Metal Feeder", "insights": { "estimatedSalesLift": 359, "suggestedUnits": 8, "customerFavorite": false } }, { "gtin": "00947388050138", "sku": "SAMS-990296591", "itemId": "3644964561", "brand": "Gain", "itemName": "Gain Ultra Powder Laundry Detergent Original (188 Ounce 183 Loads)", "insights": { "estimatedSalesLift": 303, "suggestedUnits": 19, "customerFavorite": true } }, { "gtin": "00933908665494", "sku": "First Alert SA350B", "itemId": "642411239", "brand": "First Alert", "itemName": "First Alert SA350B Smoke Alarm - Dual Ionization Sensor - Detects Flaming Fires", "insights": { "estimatedSalesLift": 227, "suggestedUnits": 13, "customerFavorite": true } } ], "totalInsights": { "sellerFulfilledPast30DaysSales": 3671, "walmartFulfilledEstimatedSales": 9486, "totalEstimatedSalesLift": 5815 }, "totalRecords": 3 }
}

Modify your code

Replace all placeholder values with your actual shipment data before making the API request.

WM_QOS.CORRELATION_ID - Use a unique correlation UUID to track the request.
WM_SEC.ACCESS_TOKEN - Replace with your valid access token obtained through authentication.

Result

If successful, the API returns 200 OK with a JSON body containing status and payload.
The payload includes key fields such as itemId, gtin, vendorSku,, and itemName.

If the API returns 400 Bad Request, one or more inputs are invalid. For example, non-boolean values are present for isInDemand or the limit is out of range.

If you see a 500 Internal Server Error, retry after sometime.

Updated about 1 hour ago