The playground

Try any of 817 endpoints — live.

Pick an endpoint, load a working example, tweak the params, and send — no signup to try. Results render the way the data deserves; raw JSON, headers & code are one tab away.

Playground demo key · api.reefapi.com
post/recall/v1/stats1 credit

Aggregate recall counts grouped by a field (classification/status/firm/state/type).

Working example
Parameters

FDA recall category. food / drug / device, or 'all' to search every category at once. (CPSC consumer-product & NHTSA vehicle recalls are out of scope — see docs; vehicle recalls live in the `vehicle` API.)

Aggregate recall counts grouped by this field (openFDA count). Returns term→count buckets.

Free-text product/keyword search over the recall's product description and reason (openFDA Lucene). e.g. 'peanut butter', 'listeria', 'airbag'. Combine with category/classification/date.

Filter by recall report_date from (on or after). ISO YYYY-MM-DD (or YYYYMMDD). Pair date_from + date_to for a range.

Filter by recall report_date to (on or before). ISO YYYY-MM-DD (or YYYYMMDD). Pair date_from + date_to for a range.

request preview
curl -X POST https://api.reefapi.com/recall/v1/stats \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"category":"food","field":"classification"}'

Hit Send to run this endpoint live.