Download schemas for Returns API

Schemas are formal definitions that specify your feed's structure, data types, and required fields. They help ensure your return-related data is correctly formatted before submission to Walmart.

A feed is a file containing structured data that details updates for one or more return actions, such as issuing refunds or updating return statuses. To learn more, refer to the Walmart Feeds guide.

Walmart provides an official JSON schema to help you validate your Returns API feed structure:

JSON schemas (ReturnOrderResponse.json, ReturnOverride.json, and related files):
MPReturnsJsonSchema.zip

These files define the required fields, data types, and structure for return-related submissions. Use the schema to validate your JSON files before uploading them, ensuring they conform to Walmart's format.

Note: Improperly formatted files can result in rejected submissions or failed refund processing.

Next step

Learn how to integrate the Returns API into your return management workflow.