--- updatedAt: 2026-06-29T21:10:45.000Z --- # Get WFS Inventory Reconciliation Report The Inventory Reconciliation Report API provides a summary of your net inventory changes during a selected time frame. It allows you to compare the beginning and ending quantities of a SKU, while also tracking the number of units sold, lost, returned, and other inventory movements in between. [block:html] { "html": "\n \n" } [/block] # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Fulfillment Management", "version": "1.0", "description": "With Walmart Fulfillment Services, you can focus on sales while Walmart expertly take care of fast shipping, seamless returns, and customer service. Simply send your inventory to Walmart fulfillment centers, where we will store your products securely and prepare them swiftly for shipping when an order is placed." }, "x-readme": { "samples-languages": [ "shell" ], "proxy-enabled": false }, "servers": [ { "url": "https://marketplace.walmartapis.com", "description": "Production URL" }, { "url": "https://sandbox.walmartapis.com", "description": "Sandbox URL" } ], "security": [ { "accessToken": [] } ], "paths": { "/v3/report/wfs/inventoryReconciliationReport": { "get": { "tags": [ "Fulfillment" ], "summary": "Get WFS Inventory Reconciliation Report", "description": "The Inventory Reconciliation Report API provides a summary of your net inventory changes during a selected time frame. It allows you to compare the beginning and ending quantities of a SKU, while also tracking the number of units sold, lost, returned, and other inventory movements in between.", "externalDocs": { "description": "View Guide", "url": "https://developer.walmart.com/us-marketplace/docs/wfs-get-inventory-reconciliation-report" }, "operationId": "getInventoryReconciliationReport", "parameters": [ { "name": "monthYear", "in": "query", "description": "This is the month and year for which you are downloading this WFS Inventory Reconciliation Report. Format (mm-YYYY).", "required": true, "schema": { "type": "string" }, "example": "01-2025" }, { "name": "gtin", "in": "query", "description": "The 14-digit Global Trade Item Number (GTIN) that identifies the product worldwide. Use digits only, with no spaces or dashes. This is only valid when you chose current month ", "required": false, "schema": { "type": "string" }, "example": "00716999676446" }, { "in": "header", "name": "Authorization", "description": "Basic authorization header. Base 64 encodes the Client ID and Client Secret retrieved in step two of the integration steps.", "required": true, "schema": { "type": "string" }, "example": "Basic YzcyOTFjNmItNzI5MC00...." }, { "in": "header", "name": "WM_CONSUMER.CHANNEL.TYPE", "description": "A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding", "required": false, "schema": { "type": "string" } }, { "in": "header", "name": "WM_QOS.CORRELATION_ID", "description": "A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID", "required": true, "schema": { "type": "string" }, "example": "b3261d2d-028a-4ef7-8602-633c23200af6" }, { "in": "header", "name": "WM_SVC.NAME", "description": "Walmart Service Name", "required": true, "schema": { "type": "string" }, "example": "Walmart Service Name" }, { "name": "WM_GLOBAL_VERSION", "description": "GLOBAL VERSION DEFAULT AS 3.1.", "in": "header", "required": true, "schema": { "type": "string", "enum": [ "3.1" ] } }, { "name": "WM_MARKET", "description": "Identifies the Walmart Marketplace region for the request. If not specified, US is used by default.", "in": "header", "required": true, "schema": { "type": "string", "enum": [ "us" ] } } ], "responses": { "200": { "description": "Successful operation", "content": { "application/octet-stream": { "schema": { "type": "string", "description": "The data is returned as a .csv file, which will be available in your designated folder. A successful API response includes a Content-Disposition header with the report attached. This header specifies the filename, for example: attachment: filename=WFSInventoryHealthReport_2021-07-15T06_42_13.766Z.csv, where the timestamp indicates when the file was generated. The attachment contains the report in CSV format.\nThe provided Java code example demonstrates how to access both the Content-Disposition header and the response body when processing the report. As the report is regenerated periodically; we recommend retrieving it no more than once per hour." } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "errors" ], "properties": { "status": { "type": "string", "example": "BAD_REQUEST" }, "errors": { "type": "array", "items": { "type": "object", "required": [ "code", "description", "severity", "category", "causes" ], "properties": { "code": { "type": "string", "example": "400.WFS.100" }, "field": { "type": "string", "nullable": true, "example": "monthYearValid" }, "description": { "type": "string", "example": "monthYear is required and should be valid." }, "info": { "type": "string", "example": "" }, "severity": { "type": "string", "example": "ERROR" }, "category": { "type": "string", "example": "REQUEST" }, "causes": { "type": "array", "items": { "type": "string" } } } } } } }, "examples": { "BadRequest": { "summary": "Bad request", "value": { "status": "BAD_REQUEST", "errors": [ { "code": "400.WFS.100", "field": "monthYearValid", "description": "monthYear is required and should be valid.", "info": "", "severity": "ERROR", "category": "REQUEST", "causes": [] } ] } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "field": { "type": "string" }, "description": { "type": "string" }, "info": { "type": "string" }, "severity": { "type": "string" }, "category": { "type": "string" }, "causes": { "type": "array", "items": {} }, "errorIdentifiers": { "type": "object" } } } } } }, "examples": { "Unauthorized": { "summary": "Unauthorized", "value": { "error": [ { "code": "UNAUTHORIZED.GMP_GATEWAY_API", "field": "WM_SEC.ACCESS_TOKEN", "description": "Invalid token", "info": "Unauthorized token or incorrect authorization header. Please verify correct format: \"Authorization: Basic Base64Encode(clientId:clientSecret)\" For more information, see https://developer.walmart.com/#/apicenter/marketPlace/latest#apiAuthentication.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ] } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "errors" ], "properties": { "status": { "type": "string", "example": "INTERNAL_SERVER_ERROR" }, "errors": { "type": "array", "items": { "type": "object", "required": [ "code", "description", "severity", "category", "causes" ], "properties": { "code": { "type": "string", "example": "500.WFS.100" }, "field": { "type": "string", "nullable": true, "example": "monthYearValid" }, "description": { "type": "string", "example": "An unexpected error occurred." }, "info": { "type": "string", "example": "Error while generating Inventory Reconciliation Report" }, "severity": { "type": "string", "example": "ERROR" }, "category": { "type": "string", "example": "REQUEST" }, "causes": { "type": "array", "items": { "type": "string" } } } } } } }, "examples": { "BadRequest": { "summary": "Internal Server Error", "value": { "status": "INTERNAL_SERVER_ERROR", "errors": [ { "code": "500.WFS.100", "field": "", "description": "An unexpected error occurred.", "info": "Error while generating Inventory Reconciliation Report.", "severity": "ERROR", "category": "REQUEST", "causes": [] } ] } } } } } } } } } }, "components": { "securitySchemes": { "accessToken": { "type": "apiKey", "in": "header", "name": "WM_SEC.ACCESS_TOKEN", "description": "An access token required for authenticating API requests. Obtain the token from `POST /v3/token` using the `client_credentials` grant type." } } } } ```