/v1/rems-programs/{rems_id}The same lookup by query fields is at GET /v1/rems-programs/lookup.
One REMS program with its covered products, paged; or, by NDC, the current program covering that product’s FDA application. A bad NDC is refused before the REMS data is read; a missing REMS release is a 503 naming the dataset rems.
rems_idstringRequiredThe program identifier from REMS-SEARCH, such as rems_24; FDA’s bare REMS ID (24) also works.
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.
ndcstringOptionalat most 64 charactersA product or package NDC, on GET /v1/rems-programs/lookup in place of rems_id. Returns the current program for its FDA application.
product_limitintegerOptionalDefaults to 20min 1 · max 100Covered products per page.
product_cursorstringOptionalThe cursor from the previous page of this program’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.
rems_idstringOptionalThe program’s identifier.
namestringOptionalThe program’s name.
statusstringOptionalcurrent; inactive when every covered product was withdrawn; released; or moved_to_shared_system when a shared-system program replaced it.
requirementsarray of stringOptionalFDA’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_countintegerOptionalmin 0How many products the program covers, withdrawn ones left out.
covered_productsarray of RemsCoveredProductOptionalThe covered products on this page.
products_pagePageMetaOptionalThe page’s limit, whether more follow, the next cursor and the total.
ndcstringOptionalBy NDC: the NDC as you sent it.
rems_requiredbooleanOptionalBy NDC: true when a current REMS program covers the product’s FDA application. false does not rule out a REMS: a kit’s parts and a product with no FDA application of its own are not evaluated.
programRemsProgramOptionalBy NDC: that current program, with its covered products paged as by rems_id; absent when none covers the product. A 409 lists the product NDCs or the programs to choose from in details.candidates.
past_programsarray of RemsPastProgramOptionalBy NDC: released or shared-system programs that covered the same application.
Errors and limits lists every code and the limits behind them.