/v1/labels/searchFind current labels by title, product and ingredient names, drug, labeler and document type. Each hit lists the label’s products and flags.
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 least 2 characters · at most 500 charactersText in the title, or a product, generic or ingredient name on the label. When nothing holds q as written, its name words are searched, and its strength and form words keep labels with such a product.
match_modestringOptionalDefaults to "auto"auto (default): titles containing q, names starting with it, or every word in any order. prefix: titles and names starting with q. exact: the whole title or name.
drug_rxcuistring or array of stringOptionalat least 1 item · at most 20 itemsLabels for products that contain this drug (an RxCUI from DRUG-SEARCH).
labelerstring or array of stringOptionalat most 300 characters · at least 1 item · at most 20 itemsThe labeler’s name.
document_typestring or array of stringOptionalprescription, otc, vaccine, plasma_derivative, allergenic or cellular_therapy.
hide_repackagersbooleanOptionalDefaults to falsetrue to leave out labels repackaged or relabeled from another company’s NDC.
limitintegerOptionalDefaults to 20min 1 · max 100Labels per page.
cursorstringOptionalThe cursor from the previous page of this same search.
A list of LabelSearchHit 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.
set_idstringRequiredThe label’s set ID.
versionintegerRequiredThe label’s current version number.
titlestringRequiredThe label’s title.
document_typestringOptionalprescription, otc, vaccine, plasma_derivative, allergenic or cellular_therapy.
effective_datestringOptionalThe label’s effective date.
labelerstringOptionalThe labeler.
repackagedbooleanOptionalTrue when the label names another company’s source NDC, or its labeler declares a repack or relabel operation for it.
boxed_warningbooleanRequiredTrue when the label has a boxed warning.
productsarray of LabelProductRequiredUp to 10 of the label’s products, by NDC.
product_countintegerRequiredmin 0How many products the label lists.
matched_nameLabelMatchedNameOptionalWhat q matched: the title or a name, whole or by its start.
Errors and limits lists every code and the limits behind them.