Process return overrides

Use the Feeds endpoint to update item-level return override settings in bulk. This endpoint enables you to customize return rules for specific products instead of using the global defaults from the Seller Center.

For example, you can apply overrides during promotional periods, for products with known quality issues, or for seasonal items. Submitting a bulk override feed helps you manage exceptions and ensure each SKU is processed according to your business requirements.

Note: These POST endpoints are throttled—if you submit too many feeds too quickly, you might hit Walmart’s rate limits and receive HTTP 429 responses. Calls are limited to 20 per day, with a maximum file size of 400KB per call, and processing can take up to 4 hours. For more details on throttling, refer to the Walmart throttling documentation.

Bulk item override feed

POST https://marketplace.walmartapis.com/v3/feeds?feedType=returnItemOverride ## Sample feed file The following JSON payload is an example feed file to update item-level return override settings for multiple SKUs. Replace the sample values with your actual override settings as needed. ```json
{ "overrides": [ { "sku": "1000000001", "overrideReturnSetting": "APPROVED" }, { "sku": "1000000002", "overrideReturnSetting": "REJECTED" } ]
}

Sample request

This sample request shows how to submit a bulk item override feed using the Feeds endpoint. The JSON feed file is uploaded as part of a multipart/form-data request.

curl -X POST "https://marketplace.walmartapis.com/v3/feeds?feedType=returnItemOverride" \ -H "Authorization: Basic <Base64EncodedConsumerKey:ConsumerSecret>" \ -H "WM_SVC.NAME: Walmart Marketplace" \ -H "WM_QOS.CORRELATION_ID: 1234567890" \ -H "Accept: application/json" \ -H "Content-Type: multipart/form-data" \ -F "file=@/path/to/your/BulkReturnOverrideFeed.json" 

import requests url = "https://marketplace.walmartapis.com/v3/feeds"
params = { "feedType": "returnItemOverride"
} headers = { "Authorization": "Basic <Base64EncodedConsumerKey:ConsumerSecret>", "WM_SVC.NAME": "Walmart Marketplace", "WM_QOS.CORRELATION_ID": "1234567890", "Accept": "application/json"
} files = { "file": ("BulkReturnOverrideFeed.json", open("/path/to/your/BulkReturnOverrideFeed.json", "rb"), "application/json")
} response = requests.post(url, headers=headers, params=params, files=files)
print("Status code:", response.status_code)
print("Response JSON:", response.json()) 

Modify your code

1. Replace <Base64EncodedConsumerKey:ConsumerSecret> with your actual Base64-encoded credentials.
2. Update /path/to/your/BulkReturnOverrideFeed.json with the actual file path to your JSON feed file.
3. Use your own unique WM_QOS.CORRELATION_ID if needed.

Sample response

{ "feedId": "1000000001"
}

Result

If successful, the API returns an HTTP status of 200 OK along with a JSON payload containing a feed ID. This feed ID uniquely identifies your bulk item override submission and can be used with the Feed Status API to monitor the processing progress of your feed.