{"openapi":"3.1.0","info":{"title":"FDA Drug Device and CQC Location Lookup API","version":"1.0.0","description":"Look up FDA NDC products, Orange Book patents and exclusivity, 510(k) decisions, drug enforcement reports, drug shortages, and CQC care locations from vendored official public bulk files. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses x402 with exact USDC on Base (8453). Each paid resource accepts POST for the call; unpaid GET/HEAD return the same 402 payment challenge for discovery.\nHow to call an operation:\n1. POST JSON matching the requestBody. An unpaid POST (including empty body) returns 402 payment terms before body validation.\n2. Compare 402 payTo, asset, and network with /api/v1/catalog and /.well-known/x402 — not only with the 402 itself.\n3. Pay and retry with payment-signature. Invalid JSON/schema after payment-signature returns 400 and is not charged. Settlement (a charge) only on 2xx. payment-signature attached ≠ charged.\nIdempotency-Key: 64 hex chars from 32 random bytes. Reuse only for the same operation and body (replays stored response, including status=partial). A new key runs a fresh call.\nIdempotency after errors: unpaid 402 does not store the key. Post-signature 402/503 release it (retry same key). Pre-reserve schema 400 does not store it. Other post-signature responses (2xx/4xx/5xx) are stored: same key+body replays; different body → 409. Stored 4xx/5xx replays are not a second charge. Prefer a new key after fixing a 4xx; after 5xx reuse the same key only for the stored error.\nPost-signature 402/503 include prior-payment-attempt (nonce, settled false|unknown). A facilitator 502 is SETTLEMENT_UNKNOWN (stored under the Idempotency-Key; cross-instance replay needs the shared store; may already be charged) — check USDC authorizationState(payer, nonce) on Base before re-signing.\nSettlement signal: settled 2xx include payment-response. 4xx/5xx do not. Do not book a cost from payment-signature alone.\nCoverage billing: HTTP 200 with status complete, partial, or failed is charged at the full listed price. Retrying missing checks needs a new settled call. 4xx/5xx are not charged.\nmissing_items.reason: timeout/rate_limited → one delayed retry (new key); upstream_down → after recovery; not_supported → never.\nInvariants: any missing_items ⇒ not status complete; sources[] is provenance only (source, url, retrievedAt), never success/error keyed by check.\nFree lookup: GET /api/v1/results/{result_id} returns stored coverage JSON (404 RESULT_NOT_FOUND if unknown/expired; not a 402). Prior-Result-Id sets replaces_result_id.\nOutputs are prechecks/drafts for human review — not official determinations, legal advice, or certified filings."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/health-codes/fda-ndc-lookup":{"post":{"operationId":"look_up_an_fda_ndc_product_or_package","summary":"Look up an FDA NDC product or package","description":"Resolve a 10-digit or 11-digit NDC, or search a proprietary/non-proprietary name, in the vendored FDA NDC Directory subset of human prescription and OTC drugs.","tags":["health-codes"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ndc":{"type":"string","pattern":"^[0-9\\-]{9,13}$"},"name":{"type":"string","minLength":2,"maxLength":120},"labeler":{"type":"string","minLength":1,"maxLength":200},"limit":{"default":20,"type":"integer","minimum":1,"maximum":50}},"additionalProperties":false},"example":{"ndc":"58151015577"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"productNdc":{"type":"string"},"packageNdc":{"type":"string"},"ndc11":{"type":"string"},"packageDescription":{"type":"string"},"proprietaryName":{"type":"string"},"nonproprietaryName":{"type":"string"},"productType":{"type":"string"},"dosageForm":{"type":"string"},"route":{"type":"string"},"labeler":{"type":"string"},"marketingCategory":{"type":"string"},"applicationNumber":{"type":"string"},"substances":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"strength":{"type":"string"},"unit":{"type":"string"}},"additionalProperties":true}},"deaSchedule":{"type":"null"},"marketingStart":{"type":"string"},"marketingEnd":{"type":"null"}},"additionalProperties":true}},"snapshotDate":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"results":[{"productNdc":"58151-155","packageNdc":"58151-155-77","ndc11":"58151-0155-77","packageDescription":"90 TABLET, FILM COATED in 1 BOTTLE (58151-155-77)","proprietaryName":"Lipitor","nonproprietaryName":"atorvastatin calcium","productType":"HUMAN PRESCRIPTION DRUG","dosageForm":"TABLET, FILM COATED","route":"ORAL","labeler":"Viatris Specialty LLC","marketingCategory":"NDA","applicationNumber":"NDA020702","substances":[{"name":"ATORVASTATIN CALCIUM TRIHYDRATE","strength":"10","unit":"mg/1"}],"deaSchedule":null,"marketingStart":"2024-05-01","marketingEnd":null}],"snapshotDate":"2026-11-13","sources":[{"source":"FDA NDC Directory (product.txt, package.txt; human Rx and OTC subset)","url":"https://www.accessdata.fda.gov/cder/ndctext.zip","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["NDC Directory lists only current listings; delisted/expired NDCs and unfinished drugs, vaccines, allergenics and plasma…","Results read the vendored NDC Directory snapshot; accessdata.fda.gov is not called at request time.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/health-codes/fda-orange-book-lookup":{"post":{"operationId":"look_up_fda_orange_book_products_patents_and_exclusivity","summary":"Look up FDA Orange Book products, patents and exclusivity","description":"Return Orange Book product, therapeutic-equivalence, patent and exclusivity rows for an application number, trade name or ingredient from the vendored Orange Book data files.","tags":["health-codes"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"applNo":{"type":"string","pattern":"^\\d{6}$"},"applType":{"type":"string","enum":["N","A"]},"tradeName":{"type":"string","minLength":1,"maxLength":200},"ingredient":{"type":"string","minLength":1,"maxLength":200},"includeDiscontinued":{"default":true,"type":"boolean"}},"additionalProperties":false},"example":{"applNo":"209637"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"products":{"type":"array","items":{"type":"object","properties":{"applType":{"type":"string"},"applNo":{"type":"string"},"productNo":{"type":"string"},"ingredient":{"type":"string"},"dosageFormRoute":{"type":"string"},"tradeName":{"type":"string"},"applicant":{"type":"string"},"applicantFullName":{"type":"string"},"strength":{"type":"string"},"teCode":{"type":"null"},"approvalDate":{"type":"string"},"rld":{"type":"string"},"rs":{"type":"string"},"marketingStatus":{"type":"string"},"patents":{"type":"array","items":{"type":"object","properties":{"patentNo":{"type":"string"},"expires":{"type":"string"},"drugSubstance":{"type":"boolean"},"drugProduct":{"type":"boolean"},"useCode":{"type":"string"},"delistRequested":{"type":"boolean"},"submitted":{"type":"string"},"expired":{"type":"boolean"}},"additionalProperties":true}},"exclusivities":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"expires":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true}},"snapshotDate":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"products":[{"applType":"N","applNo":"209637","productNo":"001","ingredient":"SEMAGLUTIDE","dosageFormRoute":"SOLUTION;SUBCUTANEOUS","tradeName":"OZEMPIC","applicant":"NOVO","applicantFullName":"NOVO NORDISK INC","strength":"2MG/1.5ML (1.34MG/ML)","teCode":null,"approvalDate":"2017-12-05","rld":"Yes","rs":"No","marketingStatus":"DISCN","patents":[{"patentNo":"8129343","expires":"2031-12-05","drugSubstance":true,"drugProduct":true,"useCode":"U-2202","delistRequested":false,"submitted":"2017-12-20"},{"patentNo":"8536122","expires":"2026-03-20","drugSubstance":true,"drugProduct":true,"useCode":"U-2202","delistRequested":false,"submitted":"2017-12-20","expired":true}],"exclusivities":[{"code":"I-961","expires":"2028-01-28"}]}],"snapshotDate":"2026-11-13","sources":[{"source":"FDA Orange Book data files (products, patent, exclusivity)","url":"https://www.fda.gov/media/76860/download","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Patents and exclusivities are returned as listed; a past expiry date is not removed, and expired:true is set when the e…","Generic (A) applications have no patents in the Orange Book patent file.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/health-codes/fda-510k-lookup":{"post":{"operationId":"look_up_an_fda_510_k_or_de_novo_decision","summary":"Look up an FDA 510(k) or De Novo decision","description":"Find a 510(k) or De Novo decision by number, applicant, device name or product code in the vendored FDA 510(k) releasable database (1996–current).","tags":["health-codes"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"kNumber":{"type":"string","pattern":"^(K|DEN)\\d{6}$"},"applicant":{"type":"string","minLength":2,"maxLength":200},"deviceName":{"type":"string","minLength":2,"maxLength":200},"productCode":{"type":"string","pattern":"^[A-Z]{3}$"},"limit":{"default":20,"type":"integer","minimum":1,"maximum":50}},"additionalProperties":false},"example":{"kNumber":"K243000"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"kNumber":{"type":"string"},"applicant":{"type":"string"},"city":{"type":"string"},"state":{"type":"null"},"country":{"type":"string"},"dateReceived":{"type":"string"},"decisionDate":{"type":"string"},"decision":{"type":"string"},"productCode":{"type":"string"},"reviewPanel":{"type":"string"},"type":{"type":"string"},"summaryOrStatement":{"type":"string"},"thirdParty":{"type":"string"},"expedited":{"type":"null"},"deviceName":{"type":"string"}},"additionalProperties":true}},"snapshotDate":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"results":[{"kNumber":"K243000","applicant":"Shenzhen Medke Technology Co., Ltd.","city":"Shenzhen","state":null,"country":"CN","dateReceived":"2024-09-26","decisionDate":"2025-06-20","decision":"SESE","productCode":"FLL","reviewPanel":"HO","type":"Traditional","summaryOrStatement":"Summary","thirdParty":"N","expedited":null,"deviceName":"Reusable Temperature Probe (T1306, T2306, T3306, T4306);  Disposable Temperature Probe (T5106, T6106)"}],"snapshotDate":"2026-11-09","sources":[{"source":"FDA 510(k) releasable database 1996–current (pmn96cur.txt)","url":"https://www.accessdata.fda.gov/premarket/ftparea/pmn96cur.zip","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["File covers 510(k)s received from 1996 (plus some earlier) to the snapshot; a missing number is not proof of no clearan…","PMA devices are not in this file.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/health-codes/fda-drug-enforcement-search":{"post":{"operationId":"search_fda_drug_recall_enforcement_reports","summary":"Search FDA drug recall enforcement reports","description":"Search vendored openFDA drug enforcement reports by recall number, firm, product text, classification or status.","tags":["health-codes"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"recallNumber":{"type":"string","pattern":"^D-\\d{4}-\\d{4}$"},"firm":{"type":"string","minLength":2,"maxLength":200},"product":{"type":"string","minLength":2,"maxLength":200},"classification":{"type":"string","enum":["Class I","Class II","Class III"]},"status":{"type":"string","enum":["Ongoing","Completed","Terminated"]},"reportDateFrom":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"reportDateTo":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"limit":{"default":20,"type":"integer","minimum":1,"maximum":50}},"additionalProperties":false},"example":{"recallNumber":"D-0075-2027"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"recallNumber":{"type":"string"},"eventId":{"type":"string"},"recallingFirm":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"classification":{"type":"string"},"status":{"type":"string"},"voluntaryMandated":{"type":"string"},"productDescription":{"type":"string"},"productQuantity":{"type":"null"},"reasonForRecall":{"type":"string"},"codeInfo":{"type":"string"},"distributionPattern":{"type":"string"},"recallInitiationDate":{"type":"string"},"centerClassificationDate":{"type":"string"},"reportDate":{"type":"string"},"terminationDate":{"type":"null"}},"additionalProperties":true}},"total":{"type":"number"},"snapshotDate":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"results":[{"recallNumber":"D-0075-2027","eventId":"100075","recallingFirm":"Safecor Health, LLC","city":"Rockford","state":"IL","country":"United States","classification":"Class II","status":"Ongoing","voluntaryMandated":"Voluntary: Firm initiated","productDescription":"Metoclopramide Tablets, USP, 5 mg, 100 Tablets per bottle, Rx Only, Manufactured for: Teva Pharmaceuticals, Parsippany,…","productQuantity":null,"reasonForRecall":"Manufacturer is recalling batches due to co-mingled tablet.","codeInfo":"Lot # 3116509, Expiry: 07/31/2027.","distributionPattern":"US Nationwide","recallInitiationDate":"2026-10-06","centerClassificationDate":"2026-10-23","reportDate":"2026-11-04","terminationDate":null}],"total":1,"snapshotDate":"2026-11-10","sources":[{"source":"openFDA drug enforcement reports","url":"https://download.open.fda.gov/drug/enforcement/drug-enforcement-0001-of-0001.json.zip","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Device and food enforcement reports are not included.","Results read the vendored openFDA snapshot; api.fda.gov is not called at request time.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/health-codes/fda-drug-shortage-lookup":{"post":{"operationId":"look_up_fda_drug_shortage_entries","summary":"Look up FDA drug shortage entries","description":"Look up vendored openFDA drug-shortage entries by generic name, package NDC or company, with the snapshot date of the export.","tags":["health-codes"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"genericName":{"type":"string","minLength":2,"maxLength":200},"packageNdc":{"type":"string","minLength":5,"maxLength":20},"company":{"type":"string","minLength":2,"maxLength":200},"status":{"type":"string","enum":["Current","To Be Discontinued","Resolved"]},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100}},"additionalProperties":false},"example":{"packageNdc":"11534-191-01"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"genericName":{"type":"string"},"presentation":{"type":"string"},"packageNdc":{"type":"string"},"companyName":{"type":"string"},"status":{"type":"string"},"availability":{"type":"string"},"dosageForm":{"type":"string"},"therapeuticCategory":{"type":"array","items":{"type":"string"}},"initialPostingDate":{"type":"string"},"updateDate":{"type":"string"},"updateType":{"type":"string"},"contactInfo":{"type":"string"}},"additionalProperties":true}},"snapshotDate":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"results":[{"genericName":"Amphetamine Aspartate Monohydrate, Amphetamine Sulfate, Dextroamphetamine Saccharate, Dextroamphetamine Sulfate Tablet","presentation":"Amphetamine Aspartate Monohydrate, Amphetamine Sulfate, Dextroamphetamine Saccharate, Dextroamphetamine Sulfate, Tablet…","packageNdc":"11534-191-01","companyName":"Sunrise Pharmaceutical, Inc.","status":"Current","availability":"Available","dosageForm":"Tablet","therapeuticCategory":["Psychiatry"],"initialPostingDate":"2022-10-12","updateDate":"2026-11-01","updateType":"Reverified","contactInfo":"732-382-6085 Monday to Friday 9 am to 3:45 pm"}],"snapshotDate":"2026-11-13","sources":[{"source":"openFDA drug shortages","url":"https://download.open.fda.gov/drug/shortages/drug-shortages-0001-of-0001.json.zip","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["An empty result means the package or name is not listed in FDA's shortage data at the snapshot date; it is not a statem…","The openFDA shortage export can lag the FDA shortage website; each response carries the snapshot date.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/health-codes/cqc-location-lookup":{"post":{"operationId":"look_up_a_cqc_registered_care_location","summary":"Look up a CQC-registered care location","description":"Look up a CQC-registered care location in England from the vendored care directory and latest published Overall ratings by location id, name, postcode or provider id.","tags":["health-codes"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"locationId":{"type":"string","pattern":"^1-\\d+$"},"name":{"type":"string","minLength":2,"maxLength":200},"postcode":{"type":"string","minLength":2,"maxLength":16},"providerId":{"type":"string","minLength":3,"maxLength":32},"limit":{"default":20,"type":"integer","minimum":1,"maximum":50}},"additionalProperties":false},"example":{"locationId":"1-10000302982"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"locationId":{"type":"string"},"providerId":{"type":"string"},"name":{"type":"string"},"alsoKnownAs":{"type":"null"},"address":{"type":"string"},"postcode":{"type":"string"},"phone":{"type":"null"},"website":{"type":"string"},"serviceTypes":{"type":"array","items":{"type":"string"}},"specialisms":{"type":"array","items":{"type":"string"}},"providerName":{"type":"string"},"localAuthority":{"type":"string"},"region":{"type":"string"},"latestCheck":{"type":"string"},"ratings":{"type":"object","properties":{"overall":{"type":"string"},"safe":{"type":"string"},"effective":{"type":"string"},"caring":{"type":"string"},"responsive":{"type":"string"},"wellLed":{"type":"string"},"publicationDate":{"type":"string"}},"additionalProperties":true},"url":{"type":"string"}},"additionalProperties":true}},"directoryDate":{"type":"string"},"ratingsDate":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"results":[{"locationId":"1-10000302982","providerId":"1-102642938","name":"Henley House","alsoKnownAs":null,"address":"333 Henley Road,Ipswich","postcode":"IP1 6TB","phone":null,"website":"https://www.greensleeves.org.uk/care-homes/henley-house-ipswich-suffolk/","serviceTypes":["Residential homes"],"specialisms":["Sensory impairments","Dementia","…"],"providerName":"Greensleeves Homes Trust","localAuthority":"Suffolk","region":"East","latestCheck":"2022-04-20","ratings":{"overall":"Good","safe":"Good","effective":"Good","caring":"Good","responsive":"Good","wellLed":"Good","publicationDate":"2022-04-20"},"url":"https://www.cqc.org.uk/location/1-10000302982"}],"directoryDate":"2026-11-04","ratingsDate":"2026-11-02","sources":[{"source":"CQC care directory","url":"https://www.cqc.org.uk/system/files/2026-11/04_November_2026_CQC_directory.csv","retrievedAt":"2026-11-14","status":"ok"},{"source":"CQC latest ratings (location-level Overall population group)","url":"https://www.cqc.org.uk/system/files/2026-11/02_November_2026_Latest_ratings.ods","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Deactivated locations are not in the active directory and return no result.","A location with no rating row returns ratings:null (unrated or newly registered).","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}