/v1/recalls/{recall_id}One recall event with all of its recalled products, paged, newest report date first.
recall_idstringRequiredThe event identifier from RECALL-SEARCH. An FDA recall number is searched with RECALL-SEARCH’s q instead.
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.
product_limitintegerOptionalDefaults to 100min 1 · max 100Products per page.
product_cursorstringOptionalThe cursor from the previous page of this event’s products.
One object. 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.
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.
productsarray of RecallProductOptionalThe recalled products on this page.
products_pagePageMetaOptionalThe page’s limit, whether more follow, the next cursor and the total.
source_urlstringOptionalLink to the recall on FDA’s site.
Errors and limits lists every code and the limits behind them.