InventoryWfs Inventory

Returns WFS-managed inventory with fulfillment insights

GET
/inventory/v4/wfs/items

Returns inventory for items managed by Walmart Fulfillment Services (WFS). Includes stock health, age buckets, and demand-intelligence fields not available on seller-fulfilled inventory.

Rate limit: 300 items per page maximum. Requests retrieving more than 100 items per page will receive X-RateLimit-Limit and X-RateLimit-Remaining headers in the response.

Authorization

walletAuth inventory:read
AuthorizationBearer <token>

In: header

Scope: inventory:read

Query Parameters

skus?string

Comma-separated seller SKUs to filter (max 50). Omit to return all WFS items.

pageSize?integer
Range1 <= value <= 300
Default100
nextToken?string

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/inventory/v4/wfs/items"
{  "pagination": {    "nextToken": "string",    "totalCount": 0  },  "inventorySummaries": [    {      "sellerSku": "string",      "walmartItemId": "string",      "gtin": "string",      "offerId": "string",      "productName": "string",      "brand": "string",      "condition": "NewItem",      "lastUpdated": "2019-08-24T14:15:22Z",      "inventoryDetails": {        "publishingStatus": "Published",        "itemLifecycle": "Active",        "stockStatus": "InStock",        "fulfillableQuantity": 0,        "reservedQuantity": {          "totalReservedQuantity": 0,          "pendingCustomerOrderQuantity": 0,          "pendingTransshipmentQuantity": 0,          "fcProcessingQuantity": 0        },        "inboundQuantity": 0,        "onHandQuantity": 0,        "unavailableQuantity": {          "inventoryReviewUnits": 0,          "inventoryMovementUnits": 0        },        "researchingQuantity": {          "totalResearchingQuantity": 0,          "researchingQuantityBreakdown": [            {              "name": "researchingQuantityInShortTerm",              "quantity": 0            }          ]        },        "unfulfillableQuantity": {          "totalUnfulfillableQuantity": 0,          "customerDamagedQuantity": 0,          "warehouseDamagedQuantity": 0,          "distributorDamagedQuantity": 0,          "carrierDamagedQuantity": 0,          "defectiveQuantity": 0,          "expiredQuantity": 0        },        "inventoryAge": {          "days0To90": 0,          "days91To180": 0,          "days181To270": 0,          "days271To365": 0,          "days365Plus": 0,          "days365To450": 0,          "days450Plus": 0        },        "firstInStockDate": "2019-08-24"      },      "inventoryInsights": {        "salesForecastWeek1to4": 0,        "salesForecastWeek5to8": 0,        "salesForecastWeek9to12": 0,        "sellThroughRate": 0,        "daysOfSupply": "string",        "outOfStockDate": "2019-08-24",        "suggestedUnits": 0,        "surplusUnits": 0,        "customerFavorite": true      }    }  ]}