Returns WFS-managed inventory with fulfillment insights

GET

/inventory/v4/wfs/items

GET

/seller/v1/inventory/v4/wfs/items

curl https://marketplace.walmart.com/seller/v1/inventory/v4/wfs/items \
     -H "Authorization: Bearer <token>"

{
  "pagination": {
    "nextToken": "string",
    "totalCount": 1
  },
  "items": [
    {
      "itemInformation": {
        "sellerSku": "string",
        "walmartItemId": "string",
        "gtin": "string",
        "offerId": "string",
        "productName": "string",
        "brand": "string",
        "condition": "New"
      },
      "inventoryData": {
        "publishingStatus": "Published",
        "itemLifecycle": "Active",
        "stockStatus": "InStock",
        "fulfillableQuantity": 1,
        "reservedQuantity": {
          "totalReservedQuantity": 1
        },
        "inboundQuantity": 1,
        "onHandQuantity": 1,
        "unavailableQuantity": {
          "inventoryReviewUnits": 1,
          "inventoryMovementUnits": 1
        },
        "inventoryAge": {
          "days0To90": 1,
          "days91To180": 1,
          "days181To270": 1,
          "days271To365": 1,
          "days365Plus": 1,
          "days365To450": 1,
          "days450Plus": 1
        },
        "firstInStockDate": "2023-01-15"
      },
      "inventoryInsights": {
        "salesForecastWeek1to4": 1.1,
        "salesForecastWeek5to8": 1.1,
        "salesForecastWeek9to12": 1.1,
        "sellThroughRate": 1.1,
        "daysOfSupply": "string",
        "outOfStockDate": "2023-01-15",
        "suggestedUnits": 1,
        "surplusUnits": 1,
        "customerFavorite": true
      }
    }
  ]
}

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.

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.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

skusstringOptional

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

pageSizeintegerOptional1-300Defaults to 100

nextTokenstringOptional

Response

Success

paginationobjectOptional

itemslist of objectsOptional

Errors

400

Bad Request Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error