---
updatedAt: 2026-07-30T22:32:10.000Z
---

# Get WFS inventory (Legacy)

<div class="callout-box" role="note" aria-label="Note">
This API is being deprecated and will be removed in 2026 (more information to come). We recommend transitioning to the new <a href="/reference/getwfsinventorydetails" target="_blank">WFS Inventory API</a>.
</div>

<br />

If you use Walmart Fulfillment Services (WFS), this endpoint retrieves inventory for items fulfilled by Walmart’s warehouses. Learn more about WFS by referring to the [Walmart WFS guide](/us-marketplace/docs/walmart-fulfillment-services-wfs-api-overview).

> **Note**: This page describes an example using only the required parameters and inputs for getting WFS inventory. For a full list of customization options and additional capabilities, refer to the [Walmart Inventory API Reference](/reference/getwfsinventory).

## Endpoint

```Text bash
GET https://marketplace.walmartapis.com/v3/fulfillment/inventory
```

## Sample request

This sample request retrieves WFS inventory without filtering by SKU. This example shows how to call the API using the required headers.

```curl
curl -X GET "https://marketplace.walmartapis.com/v3/fulfillment/inventory" \
     -H "Authorization: Basic <Base64EncodedConsumerKey:ConsumerSecret>" \
     -H "WM_SVC.NAME: Walmart Marketplace" \
     -H "WM_QOS.CORRELATION_ID: 1234567890" \
     -H "Accept: application/json" \
     -H "Content-Type: application/json"
```
```python
import requests

url = "https://marketplace.walmartapis.com/v3/fulfillment/inventory"

headers = {
    "Authorization": "Basic <Base64EncodedConsumerKey:ConsumerSecret>",
    "WM_SVC.NAME": "Walmart Marketplace",
    "WM_QOS.CORRELATION_ID": "1234567890",
    "Accept": "application/json",
    "Content-Type": "application/json"
}

# Optional: add query parameters to filter by SKU if supported
params = {
    # "sku": "SKU123,SKU456"
}

response = requests.get(url, headers=headers, params=params)
print("Status Code:", response.status_code)
print("Response JSON:", response.json())
```

### Modify your code

1. Replace `<Base64EncodedConsumerKey:ConsumerSecret>` with your seller credentials.
2. Use your unique `WM_QOS.CORRELATION_ID` for each request.
3. If you want to retrieve inventory only for specific SKUs, add them in params (for example, `"sku": "ABC123,DEF789"`). The WFS Get Inventory API has a limit of 10 SKUs per request, specifically applicable for multichannel inventory management.
4. This endpoint might return a different structure (`wfsItems` instead of `items`). Make sure your code correctly parses each field (like `status`, `available`, and `reserved`).

## Sample response

```json
{
  "headers": {
    "totalCount": 0,
    "limit": 0,
    "offset": 0
  },
  "payload": {
    "inventory": [
      {
        "sku": "string",
        "shipNodes": [
          {
            "modifiedDate": "string",
            "availToSellQty": 0,
            "onHandQty": 0,
            "shipNodeType": "string"
          }
        ]
      }
    ]
  }
}
```

## Result

If successful, the API returns an `HTTP status: 200 OK` with a JSON payload containing a headers object with the total count, limit, and offset. The payload contains an inventory array where each object lists a SKU and an array of ship node details.

## Related

Learn more about [managing WFS inventory](https://marketplacelearn.walmart.com/guides/Walmart%20Fulfillment%20Services%20\(WFS\)/WFS%20Inventory%20management/manage-wfs-inventory) on Marketplace Learn.