/v1/recalls/searchFind FDA recall events by text (including a recall number), classification, status, firm, dates and NDC. Each hit is one event with a preview of its recalled products.
AuthorizationstringRequiredBearer token with your API key. Keep the key server-side.
Idempotency-KeystringOptionalMakes a retry count once. 8 to 128 letters, digits and . _ : / + -, starting with a letter or digit. For 24 hours the key is bound to your workspace and the exact request; reusing it for different work is refused with 409.
Values go in the query string; repeat a field to send several values.
qstringOptionalat most 500 charactersText ranked against the recall number, event ID, recalling firm, product description, reason, code information and distribution pattern. Every word matches at a word start, in any order, and openFDA’s harmonized brand and generic names also count. Send an FDA recall number, such as D-1039-2019, to find that recall; a recall number or event ID matches only whole. Results come by relevance, or newest report date first without q.
classificationstring or array of stringOptionalClass I, Class II, Class III or Not Yet Classified.
enforcement_status_as_publishedstring or array of stringOptionalOngoing, Completed or Terminated, as FDA published it. Pending is accepted, but FDA has published no Pending recall.
recalling_firmstring or array of stringOptionalRecalling firm names; a name matches whole, at its start or a word’s start (never inside a word), or word by word in any order, ignoring words like Inc or LLC.
initiated_fromstringOptionalEarliest recall initiation date, YYYY-MM-DD.
initiated_tostringOptionalLatest recall initiation date, YYYY-MM-DD.
report_fromstringOptionalEarliest report date, YYYY-MM-DD.
report_tostringOptionalLatest report date, YYYY-MM-DD.
ndcstring or array of stringOptionalProduct or package NDCs in any layout, matched against the NDCs in the recall.
limitintegerOptionalDefaults to 20min 1 · max 100Events per page.
cursorstringOptionalThe cursor from the previous page of this same search.
A list of RecallCard objects, one per result; page metadata is in meta. Optional fields are left out when empty; a few return null for unknown, as their sentences say. Dates are YYYY-MM-DD and times ISO 8601 UTC.
recall_idstringRequiredThe event’s identifier, for RECALL-LOOKUP.
event_idstringOptionalFDA’s event ID.
recalling_firmstringOptionalThe recalling firm.
classificationsarray of stringOptionalThe FDA classifications of the event’s recalls.
enforcement_status_as_publishedstringOptionalThe recall’s status as FDA published it, such as Ongoing or Terminated.
reasonstringOptionalThe reason for recall, when the event’s products share one.
report_datestringOptionalThe report date.
initiated_datestringOptionalThe date the firm initiated the recall.
recalled_product_countintegerRequiredmin 1How many recalled products the event has.
product_previewarray of RecalledProductPreviewOptionalThe first recalled products, with their NDCs.
product_preview_truncatedbooleanOptionalTrue when the preview holds fewer products than the event has.
source_urlstringOptionalLink to the recall on FDA’s site.
Errors and limits lists every code and the limits behind them.