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

# WFS hazmat items on hold

Call this endpoint to identify items that are currently on Walmart Fulfillment Services (WFS) hazmat compliance hold, including `IN_REVIEW`, `ACTION_NEEDED`, and `PROHIBITED` states.

When you convert items to WFS, items that either you or Walmart's systems identify as potentially containing hazardous materials will be put on hold status for further review by our Compliance team. Use the message returned by this endpoint to review error details, identity what needs to be fixed, and resubmit the item to convert to WFS.

Some typical use cases where we can use the hazmat items on hold API are:

* Review which SKUs are blocked by hazmat hold and their current status.
* When status is `ACTION_NEEDED`, it means invalid date was identified in your item setup submission. In this APIs response, review the error field and description, correct the date, and resubmit to WFS using the [Convert items for WFS](/us-marketplace/reference/convertitemforwfs) API.
* Checking items that are `IN_REVIEW`, which can last up to 72 business hours until it clears compliance review.
* If an item is marked as `PROHIBITED`, remove or replace the item and resubmit to WFS using the [Convert items for WFS](/us-marketplace/reference/convertitemforwfs) API.

For more information related to Hazmat items and what to do if your item is considered hazmat, review\
[WFS hazardous materials (hazmat): Overview](https://marketplacelearn.walmart.com/guides/Walmart%20Fulfillment%20Services%20\(WFS\)/WFS%20item%20setup/wfs-hazardous-materials-overview?locale=en-US) in Marketplace Learn.

> **Note**: This page describes an example using only the required parameters and inputs to review hazmat items on hold. For a full list of customization options and additional capabilities, refer to the [Marketplace WFS API Reference](/us-marketplace/reference/wercsfeedback).

# Endpoint

```Text bash
POST https://marketplace.walmartapis.com/v3/items/onhold/search
```

# Sample request

This sample request demonstrates how to retrieve hazmat related information for identified by the specified GTIN.

```Text cURL
curl --request POST \
  --url 'https://marketplace.walmartapis.com/v3/items/onhold/search' \
  --header 'WM_QOS.CORRELATION_ID: 2f9d8f2b-9d7a-4f2e-9a6b-9c4e7b7d1e21' \
  --header 'WM_SEC.ACCESS_TOKEN: <ACCESS_TOKEN>' \
  --header 'WM_SVC.NAME: Walmart Marketplace' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": {
      "field": "gtin",
      "value": "06154035330299"
    },
    "filters": [
      {
        "field": "status",
        "op": "equals",
        "values": ["PROHIBITED","IN_REVIEW","ACTION_NEEDED"]
      }
    ],
    "sort": {
      "field": "updatedAt",
      "order": "DESC"
    }
  }'
```
```Text Python
import requests

url = "https://marketplace.walmartapis.com/v3/items/onhold/search"

headers = {
    "WM_QOS.CORRELATION_ID": "2f9d8f2b-9d7a-4f2e-9a6b-9c4e7b7d1e21",
    "WM_SEC.ACCESS_TOKEN": "<ACCESS_TOKEN>",
    "WM_SVC.NAME": "Walmart Marketplace",
    "Accept": "application/json",
    "Content-Type": "application/json",
}

json_data = {
    "query": {
        "field": "gtin",
        "value": "06154035330299"
    },
    "filters": [
        {
            "field": "status",
            "op": "equals",
            "values": ["PROHIBITED", "IN_REVIEW", "ACTION_NEEDED"]
        }
    ],
    "sort": {
        "field": "updatedAt",
        "order": "DESC"
    }
}

response = requests.post(url, headers=headers, json=json_data)
print(response.status_code)
print(response.text)
```

## Modify your code

* Use a unique `WM_QOS.CORRELATION_ID` for each request.
* Replace `WM_SEC.ACCESS_TOKEN` with your valid access token obtained through authentication.
* For `gtin` enter the actual GTIN for which hazmat compliance should be reviewed..

# Sample response

The following sample response shows the hazmat status for the specified GTIN. Review the `status`, `description`, `severity`, and related fields to identify what actions are required to bring the items into compliance with WFS hazmat guidelines.

```Text JSON
{
  "status": "OK",
  "header": {},
  "payload": {
    "nextCursor": "?limit=1&offset=1",
    "totalItems": 207,
    "actionNeeded": 4,
    "inReview": 203,
    "prohibited": 0,
    "items": [
      {
        "gtin": "00051494401255",
        "productName": "INNATE Response Formulas, Men Over 40 One Daily Iron Free, Multivitamin, Vegetarian, Non-GMO, 60 tablets (60 Servings",
        "category": "Medicine & Supplements",
        "subCategory": "medicine_and_supplements",
        "status": "ACTION_NEEDED",
        "sku": "SD-AB-12345",
        "createdAt": 1611140177328,
        "updatedAt": 1629992924901,
        "primaryImage": "image.jpg",
        "errors": [
          {
            "code": "ERR_EXT_DATA_4001029",
            "field": "batteryTechnologyType",
            "description": "This item may contain a lithium or lead acid battery that requires additional compliance information, check the 'Battery Type' field.",
            "severity": "ERROR",
            "category": "REQUEST"
          }
        ]
      }
    ]
  }
}
```

# Result

On success, the response includes hazmat compliance details for the requested items. When applicable error codes, descriptions, and severity explain what actions to take to ensure items are in compliance status.