--- updatedAt: 2026-06-29T21:10:45.000Z --- # Get inventory log for a WFS item Returns inventory activity logs for a seller's items stored in Walmart Fulfillment Services (WFS) fulfillment centers. If `startDate` is not specified, the response includes inventory activity from the last 90 days. You can retrieve up to 365 days of inventory activity with this API. To retrieve records older than 365 days, use the [Create report request API](https://developer.walmart.com/us-marketplace/reference/generatereport) and specify `WFS_INVENTORY_LOG` as the `reportType`. [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/fulfillment/inventory-log": { "get": { "tags": [ "Fulfillment" ], "summary": "Get inventory log for a WFS item", "description": "Returns inventory activity logs for a seller's items stored in Walmart Fulfillment Services (WFS) fulfillment centers. If `startDate` is not specified, the response includes inventory activity from the last 90 days. You can retrieve up to 365 days of inventory activity with this API. To retrieve records older than 365 days, use the [Create report request API](https://developer.walmart.com/us-marketplace/reference/generatereport) and specify `WFS_INVENTORY_LOG` as the `reportType`.", "externalDocs": { "description": "Refer to guide", "url": "/doc/us/mp/us-mp-fulfillment/#9927" }, "operationId": "getWFSInventoryLog", "parameters": [ { "name": "gtin", "in": "query", "description": "GTIN.", "required": true, "schema": { "type": "string" } }, { "name": "shipmentId", "in": "query", "description": "Shipment Id.", "required": false, "schema": { "type": "string" } }, { "name": "transactionType", "in": "query", "description": "Transaction Type.", "required": false, "schema": { "type": "string" } }, { "name": "transactionLocation", "in": "query", "description": "Transaction Location.", "required": false, "schema": { "type": "string" } }, { "name": "startDate", "in": "query", "description": "Inventory log transaction time starting range (Date in YYYY-MM-DD format).", "required": false, "schema": { "type": "string" } }, { "name": "endDate", "in": "query", "description": "Inventory log transaction time ending range (Date in YYYY-MM-DD format).", "required": false, "schema": { "type": "string" } }, { "name": "sort_by", "in": "query", "description": "Sort By Attribute (Supported Attributes: gtin, changedUnits, transactionReasonCode, transactionType, shipmentId).", "required": false, "schema": { "type": "string" } }, { "name": "sort_order", "in": "query", "description": "Sort Order (ASC or DESC).", "required": false, "schema": { "type": "string" } }, { "name": "offset", "in": "query", "description": "Offset is the number of records you wish to skip before selecting records.", "required": false, "schema": { "type": "string", "default": "0" } }, { "name": "limit", "in": "query", "description": "limit is the number of records to be returned.", "required": false, "schema": { "type": "string", "default": "50" } }, { "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" } ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "headers": { "type": "object", "properties": { "limit": { "type": "integer", "description": "Number of records to be returned", "format": "int32" }, "offset": { "type": "integer", "description": "Number of records you wish to skip before selecting records", "format": "int32" }, "totalCount": { "type": "integer", "description": "Total Count of records this request yields", "format": "int32" } }, "description": "Headers Section" }, "payload": { "type": "object", "properties": { "gtin": { "type": "string", "description": "GTIN" }, "vendorSku": { "type": "string", "description": "Vendor SKU" }, "productName": { "type": "string", "description": "Product Name" }, "inventoryLog": { "type": "array", "description": "Inventory Log records", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique Event Id" }, "fcName": { "type": "string", "description": "Fulfillment Center Short Name" }, "changedUnits": { "type": "integer", "description": "Number of inventory units changed +/- in FC as a result of this transaction", "format": "int32" }, "transactionTime": { "type": "string", "description": "Timestamp of transaction", "format": "date-time" }, "transactionLocation": { "type": "string", "description": "Transaction Location" }, "transactionReasonCode": { "type": "string", "description": "Transaction Reason Code" }, "transactionReasonDesc": { "type": "string", "description": "Transaction Reason Description" }, "transactionType": { "type": "string", "description": "Transaction Type" }, "shipmentId": { "type": "string", "description": "Shipment Id" } }, "description": "Inventory Log records" } } }, "description": "Payload Section" } } } } } } } } } }, "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." } } } } ```