# FDA Recall Search API

> FDA Recall Search API is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-10).

Searches official US FDA enforcement reports for food, drug, and medical device recalls by keyword and category, returning severity classification, reason, firm, and distribution details.

## Facts

- Endpoint: POST https://x402.forgemesh.io/fda-recalls?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fda-recall-search-api-699aba9a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YT4rNelaqN7n4PGaHeb3z

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability fda-recall-search-api-699aba9a -d '<json body>'
```

Example prompt: Can you check the FDA recalls database for any food recalls involving peanut butter — show me up to 10 results and tell me if any are Class I?

## When to prefer this

Use this endpoint when you need structured, categorized FDA recall data with severity classifications directly from US enforcement reports. Prefer this over general web search when you need machine-readable recall records with fields like Class I/II/III, recall number, and distribution area. Ideal for food-safety agents, pharmacy compliance workflows, supplement vetting, and e-commerce product safety checks that need authoritative US recall status rather than news summaries.

## Known failure modes

- No matching recalls found (zero results) — valid response, not an error
- Invalid category value outside food/drug/device enum — request rejected
- Limit exceeds maximum of 25 — request rejected
- Empty keyword with no category defaults to food category
- Payment failure — x402 payment required before data is returned
- Upstream FDA data temporarily unavailable — service error

## How this service works

Food, drug, and medical-device recall search: official US enforcement reports by category and product keyword — severity classification (Class I most serious), reason for recall, recalling firm, distribution area, and dates, newest first. Zero matches is a real answer, not an error. For food-safety, pharmacy, supplement, and commerce agents.

## Output

A JSON object containing the original query parameters, a list of recall records (each with recall number, product description, recalling firm, classification, reason, status, distribution area, and recall/report dates), a count of returned records, and an attribution note. Zero results is a valid response meaning no matching recalls were found.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 25,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "description": "product keyword, e.g. 'peanut' — empty returns newest in category"
  },
  "category": {
   "enum": [
    "food",
    "drug",
    "device"
   ],
   "type": "string",
   "description": "recall category (default food)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "classification: Class I = reasonable probability of serious harm; II = temporary/reversible harm; III = unlikely harm.",
  "query": {
   "query": "peanut",
   "category": "food"
  },
  "recalls": [
   {
    "reason": "Potential Salmonella contamination",
    "status": "Ongoing",
    "report_date": "20260810",
    "distribution": "Nationwide",
    "recall_number": "F-1234-2026",
    "classification": "Class I",
    "recalling_firm": "Example Foods LLC",
    "recall_initiated": "20260801",
    "product_description": "Example Peanut Butter 16oz jars"
   }
  ],
  "returned": 3,
  "attribution": "US FDA enforcement reports (public domain)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fda-recall-search-api-699aba9a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)