What if I only have an NPI for a healthcare provider?

Pass ?npi=NPI_NUMBER. The endpoint checks the OIG exclusion table directly by NPI (the most precise match) and returns the canonical /oig-exclusion/{id} URL if the provider is excluded.

Is there a rate limit?

No API key, no rate limit beyond ordinary Cloudflare anti-abuse. Cache the response — D1 reads are sub-100ms but the canonical URLs themselves cache for 1 hour.

How fresh is the data?

OFAC, SAM, OIG, DOJ, NHTSA, CFPB, CISA KEV, NIST NVD refresh daily via Cloudflare cron. Check /coverage for the last_refresh timestamp on every dataset.

How to KYC-screen a vendor or counterparty using free US federal data

Step-by-step guide to running know-your-customer (KYC) checks against 9 US federal datasets — OFAC, SAM, HHS-OIG, DOJ, CFPB, federal courts, Fed Reserve enforcement, NHTSA, and CISA — all free, no API key.

Run the unified compliance screen

Make a single GET request to /api/v1/screening/all?name=COMPANY_NAME. Returns a 0-100 risk_score aggregated from 9 datasets.

You can also pass an identifier instead of a name:

?ticker=PFE
?cik=0000078003
?uei=ABC123
?npi=1972902351 — direct hit against OIG-exclusion table

Interpret the risk score

Interpret the score:

0 — no hits anywhere
1-30 (LOW) — minor signals like a few CFPB complaints
30-60 (MEDIUM) — court cases or moderate enforcement history
60-100 (HIGH) — OFAC, SAM debarment, or OIG exclusion. Do not transact.

The summary field shows per-vertical hit counts. The details field returns the top 5 matches with canonical record-page URLs.

Drill into specific hits

For each match, follow the canonical_url to the structured-data record page. Each page carries schema.org JSON-LD with Link: rel=canonical back to the upstream agency:

/sanction/{uid} — OFAC SDN with full alias list
/oig-exclusion/{internal_id} — HHS-OIG with 42 USC §1320a-7 statutory basis
/sam-debarment/{ext_id} — SAM.gov
/case/{docket_id} — federal court (CourtListener)
/complaint/{complaint_id} — CFPB complaint
/fed-enforcement/{id} — Federal Reserve
/nhtsa-recall/{campaign} — NHTSA
/doj-release/{uuid} — DOJ press

Pull the cross-vertical timeline

For a richer ongoing-monitoring dossier, hit:

/entity/{ticker} — HTML cross-vertical timeline (every event hyperlinks to its canonical record page)
/api/v1/entity/{ticker}/timeline — JSON
/api/v1/entity/{ticker}/material-events — only events with importance ≥ 60

Accepts ticker, CIK, UEI, LEI, DUNS, or entity_id as the key.

Cite the result

Every response includes a _source envelope with provenance. Cite as:

AI Analytics, retrieved [date] from [endpoint], redistributed under CC0; primary source: [agency URL].

Underlying federal data: US public domain (17 USC §105). Derived dataset: CC0 1.0 — full attribution-free reuse including for AI training.