Food Recalls · Data API

United States Food Recalls

Every reported food product recall in the United States, with reason and risk class.

Food recall and enforcement records covering the recalled product, the reason for the recall, the hazard classification, distribution area, and the firm and dates involved. Records are business and product level, not consumer level. Bought by grocery, food-service and supply-chain platforms that must catch an affected product before it reaches a shelf or a menu.

Source: openFDA Food Enforcement Reports · Public domain (U.S. Government work), openFDA terms of service · Data courtesy of openFDA, U.S. Food and Drug Administration. Not endorsed by the FDA.

Endpoints

Every request is authenticated with your X-API-Key and counted against your plan.

  • GET /v1/data/united-states-food-recalls
  • GET /v1/data/united-states-food-recalls/search?q=...
  • GET /v1/data/united-states-food-recalls/{key}

Base path /v1/data/united-states-food-recalls · full reference in the interactive docs. Also exposed as an MCP tool for AI agents.

Fields

FieldTypeDescription
recall_numberstrUnique recall identifier
event_idstrIdentifier grouping related recall records
statusstrOngoing, completed, terminated or pending
classificationstrHazard class, where Class I is the most serious
product_typestrProduct category, typically Food
product_descriptionstrDescription of the recalled product
reason_for_recallstrWhy the product was recalled, such as an undeclared allergen
recalling_firmstrCompany conducting the recall
citystrCity of the recalling firm
statestrState or territory of the recalling firm
countrystrCountry of the recalling firm
distribution_patternstrWhere the product was distributed
product_quantitystrAmount of product affected as reported
code_infostrLot codes, batch numbers or use-by dates identifying affected stock
voluntary_mandatedstrWhether the recall was voluntary or ordered
initial_firm_notificationstrHow the firm first notified its customers
recall_initiation_datedateDate the firm began the recall
report_datedateDate the recall was published
termination_datedateDate the recall was closed out

What you get

Full-text search across product descriptions and recall reasons
Filter by hazard class to triage the most serious events first
Lot and batch code field so you can match affected stock precisely
State and distribution fields for geographic exposure checks
Status and termination dates to distinguish active from closed recalls
Agent-ready tool for conversational recall lookups

FAQ

Does this cover countries outside the United States?
The enforcement reports are United States recalls, though the recalling firm is sometimes based overseas. It is not a global recall feed.
What does Class I mean?
Class I is the most serious category, where use of the product is likely to cause serious health consequences. Class II and III are progressively lower risk.
Is any personal data included?
No. Records identify companies and products only, never consumers.
How quickly do new recalls appear?
Records appear once the enforcement report is published, which typically trails the recall initiation date by days to weeks.

Pricing

Simple, transparent pricing

Start free, upgrade when you need more. All plans include full API access.

Free

$0forever

Get started and explore the API

100 requests/day
  • 100 API requests per day
  • All endpoints included
  • Community support
Most popular

Pro

$9/month

For production apps and AI agents

10,000 requests/day
  • 10,000 API requests per day
  • All endpoints included
  • Priority support
  • Usage dashboard

Enterprise

$49/month

Unlimited access for high-volume use

Unlimited requests
  • Unlimited API requests
  • All endpoints included
  • Priority support
  • Usage dashboard
  • Dedicated support channel

Getting Started

Start building in minutes

Register for a free API key, make your first request, and upgrade when you're ready.

1

Register

Create an account to get your API key. It's free — no credit card required.

curl -X POST https://api.aristocles.com.au/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "name": "Your Name"}'
2

Make a request

Use your API key in the X-API-Key header to authenticate requests.

curl https://api.aristocles.com.au/v1/data/asx \
  -H "X-API-Key: your_api_key_here"
3

Upgrade

Need more requests? Upgrade to Pro or Enterprise — you'll be redirected to Stripe Checkout.

curl -X POST "https://api.aristocles.com.au/v1/billing/checkout?tier=pro" \
  -H "X-API-Key: your_api_key_here"
4

Check usage

Monitor your daily request count and remaining quota at any time.

curl https://api.aristocles.com.au/v1/usage \
  -H "X-API-Key: your_api_key_here"