# FDA Food Recall Search (openFDA)

> FDA Food Recall Search (openFDA) is a paid API for AI agents from agent402.tools, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-15).

Searches live FDA food recall and enforcement records by product or reason keyword, returning firm, classification, contamination reason, distribution scope, and dates.

## Facts

- Endpoint: GET https://agent402.tools/api/food-recalls
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fda-food-recall-search-openfda-8d8edb43
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EHBnugz-VD7uu8Zw2ocFh

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-food-recall-search-openfda-8d8edb43
```

Example prompt: Can you search the FDA food recall records for peanut butter and show me the top 5 results, including the recalling firm, classification, and reason for each recall?

## When to prefer this

Use this endpoint when you need live, authoritative FDA food recall data — e.g. checking allergen alerts, verifying whether a specific product or brand has been recalled, or investigating contamination reasons. Prefer this over general web search when you need structured, filterable recall records with official classifications and dates. No API key required.

## Known failure modes

- No results found for the search term — FDA database may have no matching recalls
- Query string missing — required 'q' parameter not provided returns error
- Limit out of range — values outside 1-20 may be rejected or clamped
- openFDA upstream outage — live data dependency may cause intermittent failures
- Overly broad query returns too many unrelated results across product categories

## How this service works

Search FDA food recall / enforcement records (openFDA): recalling firm, classification, reason (allergen, contamination, etc.), distribution, and dates. Live FDA data, no key. ?q=peanut&limit=5

## Output

Returns up to 20 FDA food recall enforcement records matching the query, each containing the recalling firm name, recall classification (Class I/II/III), reason for recall (e.g. allergen, microbial contamination), product description, distribution pattern, recall initiation and termination dates, and recall number — sourced live from openFDA.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Product or reason term to search food recalls for"
      },
      "limit": {
       "type": "number",
       "description": "Max results 1-20 (default 5)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "query",
      "count",
      "total",
      "recalls",
      "source"
     ],
     "properties": {
      "count": {
       "type": "integer"
      },
      "query": {
       "type": "string"
      },
      "total": {
       "type": "integer"
      },
      "source": {
       "type": "string"
      },
      "recalls": {
       "type": "array",
       "items": {
        "type": "object"
       }
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "query": "undeclared peanut",
  "total": 12,
  "source": "api.fda.gov (openFDA, public domain)",
  "recalls": [
   {
    "firm": "Example Foods Inc",
    "reason": "Undeclared peanut",
    "status": "Ongoing",
    "eventId": "95001",
    "product": "Chocolate chip cookies",
    "terminated": null,
    "distribution": "CA, NV, OR",
    "recallNumber": "F-1234-2026",
    "classification": "Class I",
    "recallInitiated": "2026-05-01"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fda-food-recall-search-openfda-8d8edb43/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)