/v1/shortages/searchFind FDA drug shortage presentations by text, company, status, therapeutic category, update dates and package NDC. The default view is current and to-be-discontinued shortages; a presentation ID reaches a resolved one.
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 generic name, proprietary name, presentation, company, shortage reason, manufacturer availability text and national status. Every word matches at a word start, in any order, and openFDA’s harmonized names also count. Results come by relevance, or most recently updated first without q.
shortage_idstring or array of stringOptionalShortage IDs, matched exactly. Supplying one lifts the status default unless national_shortage_status is set.
companystring or array of stringOptionalCompany names, matched whole after case, punctuation and words like Inc, LLC or USA are ignored.
national_shortage_statusstring or array of stringOptionalDefaults to ["current","to_be_discontinued"]current, resolved, to_be_discontinued or all; the default is current and to_be_discontinued. Send all on its own.
therapeutic_categorystring or array of stringOptionalFDA therapeutic categories, such as Oncology or Anesthesia, in any case. Several values match any of them.
updated_fromstringOptionalEarliest update date, YYYY-MM-DD.
updated_tostringOptionalLatest update date, YYYY-MM-DD.
package_ndcstring or array of stringOptionalPackage NDCs in any layout, matched against the shortage’s package NDC.
limitintegerOptionalDefaults to 20min 1 · max 100Presentations per page.
cursorstringOptionalThe cursor from the previous page of this same search.
A list of ShortageSearchHit 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.
shortage_idstringRequiredThe presentation’s identifier, accepted by the shortage_id filter.
generic_namestringRequiredThe generic name.
proprietary_namestringOptionalThe brand name, when the product has one.
presentationstringRequiredThe presentation as FDA describes it.
dosage_formstringOptionalThe dosage form.
strengthsarray of stringOptionalThe strengths FDA lists.
package_ndcstringOptionalThe package NDC FDA lists.
companystringRequiredThe company.
national_shortage_statusstringRequiredFDA’s national shortage status.
manufacturer_availability_textstringOptionalThe manufacturer’s availability statement.
shortage_reasonstringOptionalThe reason FDA lists for the shortage.
related_informationstringOptionalFDA’s notes on the shortage, as FDA wrote them.
estimated_recoveryShortageDateWindowOptionalWhen FDA expects supply to recover: FDA’s words, with the earliest and latest dates they mean.
next_deliveryShortageDateWindowOptionalWhen the next delivery is expected: FDA’s words, with the earliest and latest dates they mean.
allocationstringOptionalFDA’s words saying the product is on allocation.
discontinuationShortageDiscontinuationOptionalFDA’s discontinuation wording, its discontinued date and when supply ends.
resolved_notestringOptionalFDA’s note on a resolved shortage.
update_typestringOptionalThe type of FDA’s latest update.
first_posted_datestringOptionalThe date FDA first posted the shortage.
updated_datestringOptionalThe date FDA last updated it.
therapeutic_categoriesarray of stringOptionalFDA’s therapeutic categories for the drug.
contact_informationstringOptionalThe contact FDA lists.
Errors and limits lists every code and the limits behind them.