/v1/inventory/checkCheck 1 to 100 NDCs or barcodes, with lot numbers when you have them, against FDA recalls and shortages in one request, which counts as one against your allowance. Results keep your order. An empty list means none found; meta.warnings says what was searched.
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.
Send the fields as a JSON body.
itemsarray of InventoryItemInputRequiredat least 1 item · at most 100 items1 to 100 items, each an NDC in any layout or a package barcode, with an optional lot and an optional expiry as YYYY-MM or YYYY-MM-DD. Results keep their order and duplicates.
includearray of stringOptionalreason adds each matched recall’s reason for recall.
A list of InventoryItem 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.
ndcstringRequiredThe NDC as you sent it.
lotstringOptionalThe lot as you sent it, or the scan’s own lot when you sent none.
lot_sourcestringOptionalrequest when the lot is yours, scan when it came from the GS1 scan in ndc.
expirystringOptionalThe expiry as you sent it, or the scan’s own expiry when you sent none.
expiry_sourcestringOptionalrequest when the expiry is yours, scan when it came from the GS1 scan in ndc.
normalization_statusstringRequiredunchanged, normalized, ambiguous when a 10-digit NDC has several readings (each is checked), source_representation_only for an 11-digit code no NDC layout reads (matched only as printed), or invalid when nothing was checked.
normalized_ndcsarray of stringOptionalThe NDC readings that were checked.
recallsarray of InventoryRecallOptionalEach recalled product whose recall lists this NDC, at most 25.
recalls_morebooleanOptionalTrue when more than 25 recalls match.
shortagesarray of InventoryShortageOptionalEach FDA shortage presentation for this NDC, at most 25.
shortages_morebooleanOptionalTrue when more than 25 shortages match.
Errors and limits lists every code and the limits behind them.