/v1/rems-programs/searchFind FDA REMS programs by name or covered product and by requirement flags. Each program is what its latest version says; current programs only unless status asks for others.
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 program name and its covered products’ established and trade names; a match may be a whole name, a word’s start (never inside a word), or every name word in any order. REMS, form and strength words are optional.
statusstring or array of stringOptionalcurrent (the default), inactive, released or moved_to_shared_system; several values combine.
requirementstring or array of stringOptionalRequirement flags the program must have, all of them: medication_guide, communication_plan, elements_to_assure_safe_use, implementation_system, prescriber_certification, dispenser_certification, patient_enrollment or prescriber_training.
limitintegerOptionalDefaults to 20min 1 · max 100Programs per page.
cursorstringOptionalThe cursor from the previous page of this same search.
A list of RemsProgram 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.
rems_idstringRequiredThe program’s identifier, for REMS-LOOKUP.
namestringRequiredThe program’s name.
statusstringRequiredcurrent; inactive when every covered product was withdrawn; released; or moved_to_shared_system when a shared-system program replaced it.
requirementsarray of stringRequiredFDA’s requirement flags on the program’s latest version.
approved_datestringOptionalWhen FDA first approved the REMS. Absent when FDA leaves a version undated.
updated_datestringOptionalThe date of the program’s latest version: its latest change or release. Absent when FDA gives none.
covered_product_countintegerRequiredmin 0How many products the program covers, withdrawn ones left out.
covered_productsarray of RemsCoveredProductOptionalNot returned by search; REMS-LOOKUP lists the covered products.
products_pagePageMetaOptionalNot returned by search; REMS-LOOKUP lists the covered products.
Errors and limits lists every code and the limits behind them.