Frequently asked questions

21 answers covering the most common ways AI agents query US federal regulatory data through AI Analytics. Each answer routes to a concrete endpoint or canonical URL you can hit directly.

🔒 Compliance & KYC

How do I check if a person or company is on the OFAC SDN sanctions list?

Call /api/v1/sanctions/check?name=YOUR_NAME. It checks the OFAC Specially Designated Nationals list (19,680 entries + 30k aliases) with fuzzy name matching. Each match returns the OFAC UID, sanctions program, and a link to the canonical /sanction/{uid} page.

For one-shot KYC, use the unified screen — accepts name OR identifier:

Returns a 0-100 risk score covering OFAC + SAM + OIG + DOJ + CFPB + courts + Fed enforcement + NHTSA + CISA.

How do I check if a healthcare provider is excluded from Medicare or Medicaid?

Use /api/v1/debarments/check?name=NAME. It screens both the HHS-OIG List of Excluded Individuals/Entities (83,256 entries) and SAM.gov federal-contractor exclusions (106,669 entries).

Each match links to a canonical page: /oig-exclusion/{id} or /sam-debarment/{id}, with exclusion type, statutory basis (42 USC §1320a-7), and reinstatement status.

How do I check if a federal contractor is debarred?

Use /api/v1/debarments/check?name=NAME or browse /api/v1/sam-exclusions/recent. Each debarred entity has a canonical page at /sam-debarment/{ext_id}.

🔍 Search & lookup

How do I look up CVE vulnerability details combining CISA KEV and NIST NVD?

/cve/{cve_id} returns a canonical detail page combining CISA Known Exploited Vulnerabilities + NIST NVD data. Example: /cve/CVE-2024-21413 shows severity, CVSS score, ransomware-use flag, CWE codes, and CISA remediation deadline.

Recent CVEs: /api/v1/cisa/kev/recent or /api/v1/nvd/recent?severity=CRITICAL. By vendor: /api/v1/cisa/kev/by-vendor/{vendor}.

How do I find recent FDA recalls or look up a specific recall?

Recent: /api/v1/fda/recalls/recent?product=drug (or food / device).

Per-recall detail: /recall/{recall_number} — Class I/II/III classification, recalling firm, distribution pattern. Append .md for Markdown or .json for schema.org NewsArticle.

How do I find recent NHTSA vehicle recalls or check a specific recall?

Recent: /api/v1/nhtsa/recent — filter by ?park_it=1 for the most-serious "do not drive" recalls.

By manufacturer: /api/v1/nhtsa/by-manufacturer/{co}. Per-recall canonical detail: /nhtsa-recall/{campaign_number} with safety summary, consequence, remedy, and park-it / park-outside / OTA-update flags.

How do I find federal court cases involving a specific company?

By company: /api/v1/courts/by-party/{company} returns all federal court dockets (CourtListener data) where the company appears as a party.

Per-case detail: /case/{docket_id}. Filter by Nature of Suit:

How do I find CFPB consumer complaints about a specific company?

By company: /api/v1/cfpb/by-company/{company}. Each complaint has its own page at /complaint/{complaint_id} with the consumer narrative (when published), issue/sub-issue classification, and company response.

How do I look up an NIH or NSF research grant?

NIH RePORTER: /grant/nih/{appl_id} — amount, recipient, PI, activity code (R01/R21/SBIR/etc.), abstract.

NSF: /grant/nsf/{award_id}.

Browse: /api/v1/nih/recent, /api/v1/nsf/recent. By organization: /api/v1/nih/by-org/{org}.

How do I find open federal grant funding opportunities?

Recent: /api/v1/grants-gov/recent. Per-opportunity: /opportunity/{opp_id} — opportunity number, issuing agency, open/close dates, status, and CFDA codes.

How do I look up clinical trials by sponsor or by NCT ID?

Per-trial: /clinical/{nct_id} — phase, status, conditions, interventions, sponsor + collaborators, and the why_stopped reason if terminated.

Recent: /api/v1/clinical/recent?phase=PHASE3 for late-stage drug pipelines.

How do I check EPA-regulated facilities or their compliance status?

Per-facility: /facility/{frs_id} — owner organization, regulatory programs (CAA/CWA/RCRA/EPCRA/SDWA), compliance status, GPS coordinates.

Browse by owner: /api/v1/epa/facilities?owner={company}.

How do I find lobbying disclosures by company?

By client (the company being represented): /api/v1/lobbying/by-client/{company}. Per-filing: /lobbying/{filing_uuid} with registrant, quarterly income/expenses, and itemized activities keyed by issue code (HCR, ENG, TAX, etc.).

How do I see all entities active across multiple regulators?

/api/v1/cross-vertical/active returns entities active in 2+ regulators simultaneously. Identifies multi-vertical regulatory exposure that single-regulator APIs miss.

📊 Monitoring & dashboards

How do I see every regulatory event for a company across SEC, FDA, courts, and contracts?

/entity/{ticker-or-cik-or-uei} returns a unified cross-vertical timeline merging:

SEC filings, insider trades, Form 144, 13D/G, FDA recalls, drug labels, federal contracts, lobbying filings, clinical trials, court dockets, CFPB complaints, NIH grants, NHTSA recalls, DOJ press releases, Federal Reserve enforcement actions, EPA facility inspections, USPTO patents.

Each event hyperlinks to its canonical record page (the new ones we just shipped). JSON: /api/v1/entity/{key}/timeline. Material events only (importance ≥ 60): /api/v1/entity/{key}/material-events.

What major US federal regulatory events happened today?

/today is the daily-fresh cross-vertical dashboard:

  • ⚠ CISA KEVs — most-actively exploited vulnerabilities
  • ⚠ NHTSA park-it / park-outside vehicle recalls
  • 💉 FDA Class I recalls (life-threatening)
  • 🏛️ Federal court filings on high-signal NOS codes
  • 🚨 Recent DOJ press releases
  • 🔒 Newly added OFAC sanctions
  • 💰 Largest insider sells (SEC Form 4)

Available formats: /today (HTML) · /today.md (Markdown for chat) · /today.json (JSON).

📚 About the data

Where does AI Analytics get its data?

All data comes from US federal primary sources. The 23 datasets currently include:

SEC EDGAR · openFDA · OFAC Treasury · CourtListener · CFPB · NIST NVD · CISA KEV · NHTSA · DOJ · NIH RePORTER · NSF · ClinicalTrials.gov · USPTO · EPA ECHO · USAspending · Federal Register · Senate LDA · Federal Reserve · USGS · NWS · grants.gov · HHS-OIG · SAM.gov.

See the full catalog at /datasets/. Live row counts + last-refresh timestamps at /coverage.

How current is the data?

Live row counts + last-refresh timestamps for every dataset: /coverage. Machine-readable: /coverage.md, /coverage with Accept: application/json.

Most datasets refresh daily via Cloudflare cron. NPORT-P and 13F are quarterly (matching the SEC publishing cadence). The /today page surfaces the latest events across all verticals.

📝 Citation & license

Is AI Analytics licensed for AI training use? How do I cite it?

Underlying federal content: US public domain (17 USC §105, 5 USC §105). Our derived dataset: CC0 1.0 Universal — full attribution-free reuse including for AI training.

Every endpoint returns a _source envelope with provenance fields (data_provider, license, primary_source URL, generated_at timestamp).

Suggested citation format:

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

Full license details at /license.

🛠️ Developer / agent API

Is there a Model Context Protocol (MCP) server for use with Claude / ChatGPT?

Yes. /mcp is a JSON-RPC over Streamable HTTP MCP server exposing 38+ tools for cross-vertical regulatory lookups. No auth, no rate limit beyond ordinary anti-abuse.

Discovery:

Is there an OpenAPI spec or rate limit?

OpenAPI 3.1 spec: /openapi.json. No API key, no rate limit beyond ordinary Cloudflare anti-abuse.

Content negotiation on most endpoints:

  • Default → JSON
  • Accept: text/html or browser → HTML
  • Accept: text/markdown or .md suffix → Markdown
  • Accept: application/ld+json or .json suffix on record pages → schema.org JSON-LD