{"openapi":"3.1.0","info":{"title":"AI Analytics — regulatory and public-data hub","version":"0.1.0","description":"Structured US regulatory and public data from federal, self-regulatory, and third-party sources, delivered in a shape AI crawlers can consume cheaply. Source-specific terms remain in force, and free or keyless access does not alter them. See /license and each response's provenance fields. All endpoints are currently free; section-body fetches are logged with a shadow price ($0.001/section) in preparation for Cloudflare Pay Per Crawl.","contact":{"email":"info@ai-analytics.org"},"termsOfService":"https://api.ai-analytics.org/license","license":{"name":"Source-specific terms — see license policy","url":"https://api.ai-analytics.org/license"}},"servers":[{"url":"https://api.ai-analytics.org","description":"Production"},{"url":"https://api.ai-analytics.org","description":"Current host"}],"tags":[{"name":"equitable-sharing","description":"Exact institution-only views over a dated, explicitly stale DOJ ESAC snapshot."},{"name":"discovery","description":"Topics, stats, search, feed, today, openapi, sitemap, agencies"},{"name":"sec.companies","description":"SEC filers by CIK or ticker; profiles, summaries"},{"name":"sec.insider","description":"Form 4 insider transactions + leaderboards"},{"name":"sec.holdings","description":"13F institutional holdings"},{"name":"sec.financials","description":"XBRL financial facts + comparisons"},{"name":"sec.sections","description":"Per-URL filing section bodies (shadow-billable)"},{"name":"fda.recalls","description":"FDA drug/device/food enforcement actions"},{"name":"fda.adverse","description":"FAERS drug adverse-event reports"},{"name":"fda.510k","description":"FDA medical device 510(k) clearances"},{"name":"register","description":"Federal Register documents (rules, exec orders, notices)"},{"name":"weather","description":"NOAA active hazard alerts"},{"name":"climate","description":"USGS earthquake events"},{"name":"sec.funds","description":"NPORT-P mutual fund metadata"}],"paths":{"/api/v1/equitable-sharing/agencies":{"get":{"tags":["equitable-sharing"],"summary":"List institutional agency profiles for one exact source state","operationId":"json-list-institutional-agency-profiles-for-one-exact-source-state","security":[],"parameters":[{"$ref":"#/components/parameters/State"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Cursor"}],"responses":{"200":{"description":"A bounded institution-only response with mandatory source and interpretation caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingEnvelope"}}}},"400":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}},"404":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}},"405":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}},"500":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}},"503":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}}}}},"/api/v1/equitable-sharing/agencies.md":{"get":{"tags":["equitable-sharing"],"summary":"Render institutional agency profiles for one exact source state","operationId":"markdown-render-institutional-agency-profiles-for-one-exact-source-state","security":[],"parameters":[{"$ref":"#/components/parameters/State"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Cursor"}],"responses":{"200":{"description":"The same bounded response rendered as Markdown with every mandatory caveat.","content":{"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"405":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"500":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"503":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/api/v1/equitable-sharing/agencies/{ncic}":{"get":{"tags":["equitable-sharing"],"summary":"Fetch one institutional agency profile by exact NCIC","operationId":"json-fetch-one-institutional-agency-profile-by-exact-ncic","security":[],"parameters":[{"$ref":"#/components/parameters/Ncic"}],"responses":{"200":{"description":"A bounded institution-only response with mandatory source and interpretation caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingEnvelope"}}}},"400":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}},"404":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}},"405":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}},"500":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}},"503":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}}}}},"/api/v1/equitable-sharing/agencies/{ncic}.md":{"get":{"tags":["equitable-sharing"],"summary":"Render one institutional agency profile by exact NCIC","operationId":"markdown-render-one-institutional-agency-profile-by-exact-ncic","security":[],"parameters":[{"$ref":"#/components/parameters/Ncic"}],"responses":{"200":{"description":"The same bounded response rendered as Markdown with every mandatory caveat.","content":{"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"405":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"500":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"503":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/api/v1/equitable-sharing/agencies/{ncic}/certifications":{"get":{"tags":["equitable-sharing"],"summary":"List accepted agency-year certifications for one exact NCIC","operationId":"json-list-accepted-agency-year-certifications-for-one-exact-ncic","security":[],"parameters":[{"$ref":"#/components/parameters/Ncic"},{"$ref":"#/components/parameters/FiscalYearOptional"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Cursor"}],"responses":{"200":{"description":"A bounded institution-only response with mandatory source and interpretation caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingEnvelope"}}}},"400":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}},"404":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}},"405":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}},"500":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}},"503":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}}}}},"/api/v1/equitable-sharing/agencies/{ncic}/certifications.md":{"get":{"tags":["equitable-sharing"],"summary":"Render accepted agency-year certifications for one exact NCIC","operationId":"markdown-render-accepted-agency-year-certifications-for-one-exact-ncic","security":[],"parameters":[{"$ref":"#/components/parameters/Ncic"},{"$ref":"#/components/parameters/FiscalYearOptional"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Cursor"}],"responses":{"200":{"description":"The same bounded response rendered as Markdown with every mandatory caveat.","content":{"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"405":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"500":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"503":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/api/v1/equitable-sharing/agencies/{ncic}/status":{"get":{"tags":["equitable-sharing"],"summary":"List DOJ top-level status history for one exact NCIC","operationId":"json-list-doj-top-level-status-history-for-one-exact-ncic","security":[],"parameters":[{"$ref":"#/components/parameters/Ncic"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Cursor"}],"responses":{"200":{"description":"A bounded institution-only response with mandatory source and interpretation caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingEnvelope"}}}},"400":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}},"404":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}},"405":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}},"500":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}},"503":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}}}}},"/api/v1/equitable-sharing/agencies/{ncic}/status.md":{"get":{"tags":["equitable-sharing"],"summary":"Render DOJ top-level status history for one exact NCIC","operationId":"markdown-render-doj-top-level-status-history-for-one-exact-ncic","security":[],"parameters":[{"$ref":"#/components/parameters/Ncic"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Cursor"}],"responses":{"200":{"description":"The same bounded response rendered as Markdown with every mandatory caveat.","content":{"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"405":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"500":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"503":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/api/v1/equitable-sharing/certifications":{"get":{"tags":["equitable-sharing"],"summary":"List accepted certifications for one exact source state and fiscal year","operationId":"json-list-accepted-certifications-for-one-exact-source-state-and-fiscal-year","security":[],"parameters":[{"$ref":"#/components/parameters/State"},{"$ref":"#/components/parameters/FiscalYear"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Cursor"}],"responses":{"200":{"description":"A bounded institution-only response with mandatory source and interpretation caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingEnvelope"}}}},"400":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}},"404":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}},"405":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}},"500":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}},"503":{"description":"A non-cacheable contract error with mandatory dataset caveats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquitableSharingError"}}}}}}},"/api/v1/equitable-sharing/certifications.md":{"get":{"tags":["equitable-sharing"],"summary":"Render accepted certifications for one exact source state and fiscal year","operationId":"markdown-render-accepted-certifications-for-one-exact-source-state-and-fiscal-year","security":[],"parameters":[{"$ref":"#/components/parameters/State"},{"$ref":"#/components/parameters/FiscalYear"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Cursor"}],"responses":{"200":{"description":"The same bounded response rendered as Markdown with every mandatory caveat.","content":{"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"405":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"500":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}},"503":{"description":"A non-cacheable Markdown contract error with mandatory dataset caveats.","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/api/v1/resolve":{"get":{"tags":["entity"],"summary":"Entity locator — name/ticker/CIK to canonical identity + which datasets contain it (available_in map) + links","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Entity name (>=3 chars)"},{"name":"ticker","in":"query","schema":{"type":"string"}},{"name":"cik","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Thing JSON-LD with entity, aliases, available_in, links"}}}},"/api/v1/screening/batch":{"post":{"tags":["screening"],"summary":"Batch compliance screening — up to 50 entities in one call (40-source risk per entity)","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"names":{"type":"array","items":{"type":"string"},"maxItems":50}}}}}},"responses":{"200":{"description":"ItemList: per-entity risk_score/level/summary, highest-risk-first"}}}},"/api/v1/compare/risk":{"get":{"tags":["screening"],"summary":"Two-entity compliance-risk comparison (side-by-side 40-source diff + verdict)","parameters":[{"name":"a","in":"query","required":true,"schema":{"type":"string"}},{"name":"b","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"AnalysisNewsArticle: risk scores, verdict, biggest_differences"}}}},"/api/v1/influence/{name_or_uei}":{"get":{"tags":["entity"],"summary":"Contractor influence chain — federal contracts + subawards + lobbying + FEC committees/MURs for one entity","parameters":[{"name":"name_or_uei","in":"path","required":true,"schema":{"type":"string"},"description":"Company name or 12-char UEI"}],"responses":{"200":{"description":"AnalysisNewsArticle: tallies + records across sources"}}}},"/api/v1/owner/{owner_associate_id}":{"get":{"tags":["entity"],"summary":"Common-owner rollup — every Medicare facility an organization owner controls (hospital/hospice/HHA/SNF), PE/REIT flags","parameters":[{"name":"owner_associate_id","in":"path","required":true,"schema":{"type":"string"},"description":"Numeric CMS owner associate id"}],"responses":{"200":{"description":"Organization JSON-LD"},"404":{"description":"owner not found"}}}},"/api/v1/owners/private-equity":{"get":{"tags":["entity"],"summary":"Private-equity-flagged organization owners of Medicare facilities (most facilities first)","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":100,"maximum":500}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/owners/largest":{"get":{"tags":["entity"],"summary":"Largest organization owners of Medicare facilities by facility count","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":100,"maximum":500}},{"name":"reit","in":"query","schema":{"type":"string","enum":["1"]},"description":"reit=1 to filter to REIT owners"}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/entity/{key}/relationships":{"get":{"tags":["entity"],"summary":"Company relationship graph — shared-officer edges (board interlock / multi-company execs) for one entity","parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"},"description":"Ticker, CIK, or name"},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList of shared_officer edges"},"404":{"description":"entity has no SEC CIK"}}}},"/api/v1/lobbying/issues":{"get":{"tags":["datasets"],"summary":"Federal lobbying grouped by LDA general-issue code (activity + filing counts)","responses":{"200":{"description":"ItemList of issue codes"}}}},"/api/v1/lobbying/issue/{code}":{"get":{"tags":["datasets"],"summary":"Top clients lobbying on one issue (by reported spend) — e.g. HCR, DEF, TAX","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"},"description":"LDA 2-4 letter issue code"},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"ItemList of clients"},"404":{"description":"unknown issue code"}}}},"/api/v1/freshness":{"get":{"tags":["discovery"],"summary":"Per-dataset freshness with distinct source-observation and indexed-content watermarks","parameters":[{"name":"status","in":"query","schema":{"type":"string","enum":["FRESH","AGING","STALE","UNKNOWN"]}}],"responses":{"200":{"description":"Dataset JSON-LD with per-dataset status, status basis, source observation, and content watermark"}}}},"/api/v1/injury-mortality":{"get":{"tags":["datasets"],"summary":"CDC injury mortality records (recent)","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/disease/recent":{"get":{"tags":["datasets"],"summary":"CDC NNDSS notifiable-disease counts (recent)","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/hospital-quality/complications":{"get":{"tags":["datasets"],"summary":"CMS hospital complication rates","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}},{"name":"state","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/hospital-quality/hcahps":{"get":{"tags":["datasets"],"summary":"CMS hospital HCAHPS patient-experience scores","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/hospital-quality/infections":{"get":{"tags":["datasets"],"summary":"CMS hospital infection rates","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}},{"name":"state","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/inpatient/by-drg":{"get":{"tags":["datasets"],"summary":"Medicare inpatient charges by DRG","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}},{"name":"state","in":"query","schema":{"type":"string"}},{"name":"drg","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/inpatient/by-provider":{"get":{"tags":["datasets"],"summary":"Medicare inpatient charges by provider","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}},{"name":"state","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/pac/utilization":{"get":{"tags":["datasets"],"summary":"CMS post-acute care utilization","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/generators/largest":{"get":{"tags":["datasets"],"summary":"Largest US power generators by capacity","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/plant-owners/largest":{"get":{"tags":["datasets"],"summary":"EIA power-plant owners","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/plants/by-state":{"get":{"tags":["datasets"],"summary":"EIA power plants","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}},{"name":"state","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/aqi/county-history":{"get":{"tags":["datasets"],"summary":"EPA AQS daily county air-quality index","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/air-facility/by-pgm":{"get":{"tags":["datasets"],"summary":"EPA ICIS air facilities","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}},{"name":"state","in":"query","schema":{"type":"string"}},{"name":"pgm","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/rcra/facilities":{"get":{"tags":["datasets"],"summary":"EPA RCRA hazardous-waste facilities","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}},{"name":"state","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/water-system/visits":{"get":{"tags":["datasets"],"summary":"EPA SDWA site visits","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/sdwa/violations":{"get":{"tags":["datasets"],"summary":"EPA Safe Drinking Water Act violations","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/sdwa/systems":{"get":{"tags":["datasets"],"summary":"EPA SDWA public water systems","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/federal-register/recent":{"get":{"tags":["datasets"],"summary":"Federal Register rules & notices (full text)","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/crashes/by-carrier":{"get":{"tags":["datasets"],"summary":"FMCSA crashes by carrier","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/carriers/flagged":{"get":{"tags":["datasets"],"summary":"FMCSA carriers flagged in SMS BASIC safety categories (over the intervention threshold)","parameters":[{"name":"state","in":"query","schema":{"type":"string"},"description":"2-letter state filter (carrier physical state)"},{"name":"basic","in":"query","schema":{"type":"string","enum":["unsafe_driv","hos_driv","driv_fit","contr_subst","veh_maint"]},"description":"Filter to carriers flagged in a specific BASIC category"},{"name":"min_alerts","in":"query","schema":{"type":"integer","default":1,"minimum":1,"maximum":5},"description":"Minimum number of BASIC alerts"},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"ItemList JSON-LD of flagged carriers with alert categories, OOS counts, and /carrier/{dot} links"}}}},"/api/v1/advisers/search":{"get":{"tags":["datasets"],"summary":"Search SEC-registered investment advisers by name (FTS5)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/advisers/flagged":{"get":{"tags":["datasets"],"summary":"Investment advisers reporting Form ADV Item 11 disciplinary disclosures","parameters":[{"name":"state","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string","enum":["RIA","ERA"]}},{"name":"kind","in":"query","schema":{"type":"string","enum":["criminal","regulatory","civil"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/advisers":{"get":{"tags":["datasets"],"summary":"Investment advisers ranked by regulatory AUM (filter state/type/min_raum)","parameters":[{"name":"state","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string","enum":["RIA","ERA"]}},{"name":"min_raum","in":"query","schema":{"type":"integer"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/advisers/{crd}":{"get":{"tags":["datasets"],"summary":"Single SEC investment adviser by CRD number (RAUM, custody, Item 11 disclosures)","parameters":[{"name":"crd","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"FinancialService JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/340b/search":{"get":{"tags":["datasets"],"summary":"Search HRSA 340B covered entities by name (FTS5)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/340b":{"get":{"tags":["datasets"],"summary":"340B covered entities ranked by contract-pharmacy count (filter state/type/participating)","parameters":[{"name":"state","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string"}},{"name":"participating","in":"query","schema":{"type":"string","enum":["0","1"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/340b/pharmacy/{pharmacyId}":{"get":{"tags":["datasets"],"summary":"Every 340B covered entity using a given contract pharmacy (reverse lookup)","parameters":[{"name":"pharmacyId","in":"path","required":true,"schema":{"type":"integer"}},{"name":"limit","in":"query","schema":{"type":"integer","default":100,"maximum":500}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/340b/{id340b}":{"get":{"tags":["datasets"],"summary":"Single 340B covered entity + its contract pharmacies","parameters":[{"name":"id340b","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"MedicalOrganization JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/bsee":{"get":{"tags":["datasets"],"summary":"BSEE offshore incident-enforcement summary + worst operators","responses":{"200":{"description":"Dataset JSON-LD"}}}},"/api/v1/bsee/search":{"get":{"tags":["datasets"],"summary":"Search BSEE offshore oil & gas operators by name (FTS5)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/bsee/worst":{"get":{"tags":["datasets"],"summary":"Offshore operators ranked by BSEE enforcement (facility shut-ins / events / warnings)","parameters":[{"name":"sort","in":"query","schema":{"type":"string","enum":["fac_shutins","comp_shutins","events","warnings"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/bsee/operator/{code}":{"get":{"tags":["datasets"],"summary":"Single offshore operator: enforcement rollup + recent events","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Organization JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/sec/ftd":{"get":{"tags":["datasets"],"summary":"SEC fails-to-deliver summary + top issuers + monthly totals","responses":{"200":{"description":"Dataset JSON-LD"}}}},"/api/v1/sec/ftd/top":{"get":{"tags":["datasets"],"summary":"Securities ranked by total fail-to-deliver shares (rolling 12mo)","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":100,"maximum":500}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/sec/ftd/search":{"get":{"tags":["datasets"],"summary":"Search fails-to-deliver by issuer name or ticker (FTS5)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/sec/ftd/cusip/{cusip}":{"get":{"tags":["datasets"],"summary":"Per-security fails-to-deliver rollup + recent daily series","parameters":[{"name":"cusip","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Dataset JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/finra/short-volume":{"get":{"tags":["datasets"],"summary":"FINRA short-sale volume summary + most-shorted liquid leaderboard","responses":{"200":{"description":"Dataset JSON-LD"}}}},"/api/v1/finra/short-volume/search":{"get":{"tags":["datasets"],"summary":"FINRA short-sale volume by ticker (FTS5)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/finra/short-volume/{symbol}":{"get":{"tags":["datasets"],"summary":"Per-symbol short-volume summary (avg/latest/peak short %)","parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Dataset JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/rmp":{"get":{"tags":["datasets"],"summary":"EPA RMP chemical-accident summary + worst parents + worst chemicals","responses":{"200":{"description":"Dataset JSON-LD"}}}},"/api/v1/rmp/search":{"get":{"tags":["datasets"],"summary":"Search EPA RMP hazardous-chemical facilities by name/parent (FTS5)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/rmp/worst":{"get":{"tags":["datasets"],"summary":"Parent companies ranked by RMP chemical-accident harm (deaths/injuries/accidents)","parameters":[{"name":"sort","in":"query","schema":{"type":"string","enum":["deaths","injuries","accidents"]}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/rmp/facility/{id}":{"get":{"tags":["datasets"],"summary":"RMP facility + its chemical-accident history","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Place JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/rmp/accident/{id}":{"get":{"tags":["datasets"],"summary":"Single RMP chemical accident + chemicals released","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Event JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/csb":{"get":{"tags":["datasets"],"summary":"CSB chemical-incident investigations summary + by-state + recent","responses":{"200":{"description":"Dataset JSON-LD"}}}},"/api/v1/csb/search":{"get":{"tags":["datasets"],"summary":"Search CSB investigations (FTS5 title/location/summary)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/csb/list":{"get":{"tags":["datasets"],"summary":"CSB investigations filtered by state/status/year","parameters":[{"name":"state","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string","enum":["current","completed"]}},{"name":"year","in":"query","schema":{"type":"integer"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/csb/{tid}":{"get":{"tags":["datasets"],"summary":"Single CSB investigation","parameters":[{"name":"tid","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Report JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/itc":{"get":{"tags":["datasets"],"summary":"USITC trade-remedy summary (AD/CVD + Section 337) + class breakdown + recent active","responses":{"200":{"description":"Dataset JSON-LD"}}}},"/api/v1/itc/search":{"get":{"tags":["datasets"],"summary":"Search USITC trade investigations by number/title/product (FTS5)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/itc/list":{"get":{"tags":["datasets"],"summary":"USITC investigations filtered by class/active/year","parameters":[{"name":"class","in":"query","schema":{"type":"string","enum":["ADCVD","SECTION_337","FACTFINDING","MISC"]}},{"name":"active","in":"query","schema":{"type":"string","enum":["0","1"]}},{"name":"year","in":"query","schema":{"type":"integer"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/itc/{id}":{"get":{"tags":["datasets"],"summary":"Single USITC trade investigation","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Legislation JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/fcc/grantees/root":{"get":{"tags":["datasets"],"summary":"FCC equipment-authorization grantees summary + by-country","responses":{"200":{"description":"Dataset JSON-LD"}}}},"/api/v1/fcc/grantees/search":{"get":{"tags":["datasets"],"summary":"Search FCC equipment grantees by name (FTS5), optional country filter","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/fcc/grantees/list":{"get":{"tags":["datasets"],"summary":"FCC grantees filtered by country/state","parameters":[{"name":"country","in":"query","schema":{"type":"string"}},{"name":"state","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/fcc/grantees/{code}":{"get":{"tags":["datasets"],"summary":"Single FCC grantee by code","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Organization JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/fcc/broadcast":{"get":{"tags":["datasets"],"summary":"FCC broadcast station directory summary + by-service + by-state","responses":{"200":{"description":"Dataset JSON-LD"}}}},"/api/v1/fcc/broadcast/search":{"get":{"tags":["datasets"],"summary":"Search FCC broadcast stations by call sign or community (FTS5)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/fcc/broadcast/{facility_id}":{"get":{"tags":["datasets"],"summary":"Single broadcast station by FCC facility ID","parameters":[{"name":"facility_id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"BroadcastService JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/fhfa/hpi":{"get":{"tags":["datasets"],"summary":"FHFA House Price Index summary + by-level + by-flavor","responses":{"200":{"description":"Dataset JSON-LD"}}}},"/api/v1/fhfa/hpi/search":{"get":{"tags":["datasets"],"summary":"Search FHFA HPI geographies by name (FTS5)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/fhfa/hpi/{place_id}":{"get":{"tags":["datasets"],"summary":"Full house-price index history for one geography","parameters":[{"name":"place_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Dataset JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/usda/crop-insurance":{"get":{"tags":["datasets"],"summary":"USDA RMA crop-insurance summary + by-year + by-commodity","responses":{"200":{"description":"Dataset JSON-LD"}}}},"/api/v1/usda/crop-insurance/search":{"get":{"tags":["datasets"],"summary":"Search crop-insurance counties by name/state (FTS5)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/usda/crop-insurance/{place_id}":{"get":{"tags":["datasets"],"summary":"Full crop-insurance history for one county ({state_fips}-{county_fips})","parameters":[{"name":"place_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"County rollup JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/irs/income-by-zip":{"get":{"tags":["datasets"],"summary":"IRS SOI income-by-ZIP summary + by-bracket + by-state","responses":{"200":{"description":"Dataset JSON-LD"}}}},"/api/v1/irs/income-by-zip/search":{"get":{"tags":["datasets"],"summary":"Search IRS SOI income data by ZIP / state (FTS5)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/irs/income-by-zip/{zip}":{"get":{"tags":["datasets"],"summary":"Income/tax profile for one ZIP code (by AGI bracket)","parameters":[{"name":"zip","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Dataset JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/uscg/vessels":{"get":{"tags":["datasets"],"summary":"USCG documented-vessels summary + by-service/flag/hull/state","responses":{"200":{"description":"Dataset JSON-LD"}}}},"/api/v1/uscg/vessels/search":{"get":{"tags":["datasets"],"summary":"Search USCG documented vessels by name / official number (FTS5)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/uscg/vessels/{vessel_id}":{"get":{"tags":["datasets"],"summary":"Single documented vessel by USCG Vessel ID","parameters":[{"name":"vessel_id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Product/Vehicle JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/usda/ag-census":{"get":{"tags":["datasets"],"summary":"USDA Census of Agriculture (county) summary","responses":{"200":{"description":"Dataset JSON-LD"}}}},"/api/v1/usda/ag-census/search":{"get":{"tags":["datasets"],"summary":"Search ag-census counties by name/state (FTS5)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/usda/ag-census/{place_id}":{"get":{"tags":["datasets"],"summary":"County farm economy ({state_fips}-{county_code}): farms, acreage, sales, top commodities","parameters":[{"name":"place_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Dataset JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/census/building-permits":{"get":{"tags":["datasets"],"summary":"Census Building Permits (county) summary + latest-year totals","responses":{"200":{"description":"Dataset JSON-LD"}}}},"/api/v1/census/building-permits/search":{"get":{"tags":["datasets"],"summary":"Search building-permits counties by name/state (FTS5)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/census/building-permits/{place_id}":{"get":{"tags":["datasets"],"summary":"County residential-permit history ({state_fips}-{county_fips}): units & valuation by structure type","parameters":[{"name":"place_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Dataset JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/hud/fair-market-rents":{"get":{"tags":["datasets"],"summary":"HUD Fair Market Rents (FY2026) summary","responses":{"200":{"description":"Dataset JSON-LD"}}}},"/api/v1/hud/fair-market-rents/search":{"get":{"tags":["datasets"],"summary":"Search FMR areas by name/county/state (FTS5)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/hud/fair-market-rents/{place_id}":{"get":{"tags":["datasets"],"summary":"Fair Market Rents for one area (10-digit HUD fips): 0-4BR rents","parameters":[{"name":"place_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Dataset JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/irs/migration-flows":{"get":{"tags":["datasets"],"summary":"IRS county-to-county migration flows summary + top net gainers/losers","responses":{"200":{"description":"Dataset JSON-LD"}}}},"/api/v1/irs/migration-flows/search":{"get":{"tags":["datasets"],"summary":"Search migration-flow counties by name/state (FTS5)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/irs/migration-flows/{place_id}":{"get":{"tags":["datasets"],"summary":"County net migration + top origins/destinations ({state_fips}-{county_fips})","parameters":[{"name":"place_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Dataset JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/finra/short-interest":{"get":{"tags":["datasets"],"summary":"FINRA short interest summary + highest days-to-cover + largest short positions","responses":{"200":{"description":"Dataset JSON-LD"}}}},"/api/v1/finra/short-interest/search":{"get":{"tags":["datasets"],"summary":"FINRA short interest by ticker or name (FTS5)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/finra/short-interest/{symbol}":{"get":{"tags":["datasets"],"summary":"Per-symbol short interest (shares short, days-to-cover, change)","parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Dataset JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/short-squeeze":{"get":{"tags":["datasets"],"summary":"Short-squeeze leaderboard — composite of days-to-cover + short volume % + fails-to-deliver","parameters":[{"name":"min_score","in":"query","schema":{"type":"integer","maximum":100}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/short-squeeze/{symbol}":{"get":{"tags":["datasets"],"summary":"Per-symbol short-squeeze score + the 3 underlying component signals","parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Dataset JSON-LD"},"404":{"description":"Not found"}}}},"/api/v1/colleges/completions":{"get":{"tags":["datasets"],"summary":"IPEDS college completions","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/colleges/largest-enrollment":{"get":{"tags":["datasets"],"summary":"Largest colleges by enrollment","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/colleges/by-state":{"get":{"tags":["datasets"],"summary":"Colleges by state","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}},{"name":"state","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/cves/critical":{"get":{"tags":["datasets"],"summary":"Critical-severity CVEs (NVD CVSS v3 CRITICAL)","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/sec/form-4/recent":{"get":{"tags":["datasets"],"summary":"SEC Form 4 insider transactions (recent)","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/contracts/largest":{"get":{"tags":["datasets"],"summary":"USAspending federal contracts (largest)","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/contracts/recent":{"get":{"tags":["datasets"],"summary":"USAspending federal contracts (recent)","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"ItemList JSON-LD"}}}},"/api/v1/topics":{"get":{"tags":["discovery"],"summary":"List all data topics with status, counts, latest date, and example endpoints","responses":{"200":{"description":"OK"}}}},"/api/v1/stats":{"get":{"tags":["discovery"],"summary":"Comprehensive aggregate counts across all topics + pay-per-crawl shadow ledger","responses":{"200":{"description":"summary, documents_by_topic, sec_filings_by_form, sections_by_doc_type, pay_per_crawl_shadow_ledger"}}}},"/api/v1/agencies":{"get":{"tags":["discovery"],"summary":"Cross-source entities: SEC industries (by SIC), FDA firms, FR agencies","parameters":[{"name":"source","in":"query","schema":{"type":"string","enum":["sec","fda","register"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/":{"get":{"tags":["discovery"],"summary":"Landing — live counts + active topics + endpoint catalog","responses":{"200":{"description":"OK"}}}},"/api/v1/sec/filings/recent":{"get":{"tags":["sec.companies"],"summary":"Generic SEC filing search — by form_type, family, ticker, cik, days","parameters":[{"name":"form_type","in":"query","schema":{"type":"string"},"example":"8-K"},{"name":"family","in":"query","schema":{"type":"string","enum":["annual","quarterly","current","insider","holdings","proxy","registration","other"]}},{"name":"ticker","in":"query","schema":{"type":"string"}},{"name":"cik","in":"query","schema":{"type":"string"}},{"name":"days","in":"query","schema":{"type":"integer","default":7,"maximum":365}},{"name":"limit","in":"query","schema":{"type":"integer","default":100,"maximum":1000}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/search":{"get":{"tags":["discovery"],"summary":"Full-text search across all section bodies (BM25)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"topic","in":"query","schema":{"type":"string","enum":["sec","fda"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":200}}],"responses":{"200":{"description":"Matched sections with BM25 rank + <mark> snippets"}}}},"/feed.json":{"get":{"tags":["discovery"],"summary":"JSON Feed v1.1 of newly surfaced records with routable detail backing, in insertion order (not publication chronology)","parameters":[{"name":"topic","in":"query","schema":{"type":"string","enum":["sec","weather","register","fda","climate"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"minimum":1,"maximum":200}}],"responses":{"200":{"description":"application/feed+json"},"400":{"description":"Invalid or unknown topic; response lists allowed topics and is not cached"}}}},"/today.json":{"get":{"tags":["discovery"],"summary":"On-request cross-topic digest with inclusive UTC calendar source-date bounds and explicit freshness caveats","parameters":[{"name":"days","in":"query","schema":{"type":"integer","default":7,"minimum":1,"maximum":30}}],"responses":{"200":{"description":"OK — one envelope with sec.* and fda.* sub-objects"}}}},"/sitemap.xml":{"get":{"tags":["discovery"],"summary":"Sitemap index (links to paginated /sitemap-N.xml pages of section URLs)","responses":{"200":{"description":"OK"}}}},"/api/v1/sec/funds/recent":{"get":{"tags":["sec.holdings"],"summary":"Recent NPORT-P mutual fund filings (fund-level metadata)","parameters":[{"name":"min_net_assets","in":"query","schema":{"type":"number"}},{"name":"period","in":"query","schema":{"type":"string","format":"date"}},{"name":"registrant","in":"query","schema":{"type":"string","description":"Substring match on fund family name"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/weather/alerts/active":{"get":{"tags":["weather"],"summary":"Active NOAA/NWS weather alerts","parameters":[{"name":"severity","in":"query","schema":{"type":"string","enum":["Extreme","Severe","Moderate","Minor"]}},{"name":"event","in":"query","schema":{"type":"string","description":"Substring filter on event type (e.g., Tornado, Flood)"}},{"name":"state","in":"query","schema":{"type":"string","description":"2-letter state code"}},{"name":"limit","in":"query","schema":{"type":"integer","default":100,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/companies":{"get":{"tags":["sec.companies"],"summary":"List companies (cursor-paginated by last_filing_date)","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":100,"maximum":500}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/companies/{cik_or_ticker}":{"get":{"tags":["sec.companies"],"summary":"Company detail (accepts 10-digit CIK or stock ticker)","parameters":[{"name":"cik_or_ticker","in":"path","required":true,"schema":{"type":"string"},"example":"AAPL"}],"responses":{"200":{"description":"Detail + recent filings + insider summary"}}}},"/api/v1/sec/companies/{cik_or_ticker}/insider-transactions":{"get":{"tags":["sec.insider"],"summary":"Form 4 transactions for this company","parameters":[{"name":"cik_or_ticker","in":"path","required":true,"schema":{"type":"string"}},{"name":"since","in":"query","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","schema":{"type":"integer","default":200,"maximum":1000}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/companies/{cik_or_ticker}/insider-summary":{"get":{"tags":["sec.insider"],"summary":"Aggregated insider activity for this company across 7/30/90/365d windows","parameters":[{"name":"cik_or_ticker","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/companies/{cik_or_ticker}/profile":{"get":{"tags":["sec.companies"],"summary":"Comprehensive dossier — basic info, recent filings, insider activity, financial facts","parameters":[{"name":"cik_or_ticker","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/companies/{cik_or_ticker}/peers":{"get":{"tags":["sec.companies"],"summary":"Peer companies in the same SIC industry","description":"Ranked by most-recent filing date so the list surfaces actively-filing peers, not shell companies.","parameters":[{"name":"cik_or_ticker","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":15,"maximum":100}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/insider-leaderboard":{"get":{"tags":["sec.insider"],"summary":"Top insiders by total $ activity across all companies","parameters":[{"name":"days","in":"query","schema":{"type":"integer","default":30,"maximum":365}},{"name":"direction","in":"query","schema":{"type":"string","enum":["sells","buys","both"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/watchlist":{"get":{"tags":["sec.companies"],"summary":"Multi-ticker consolidated activity rollup","description":"Pass up to 25 tickers. One row per ticker with 30-day insider net flow, Form 144 sale pressure, recent material events, cluster-sell flag. Designed for portfolio-monitoring agents.","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated tickers (max 25)"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/ask":{"get":{"tags":["discovery"],"summary":"Natural-language → routed endpoint via Workers AI","description":"Ask in English. A small Llama model picks the right tool from the same set the /mcp server exposes and dispatches.","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK with routed.{tool,arguments,reasoning} + result"}}}},"/api/v1/sec/most-active":{"get":{"tags":["sec.filings"],"summary":"Companies with the highest filing volume in a recent window","description":"High filing volume can indicate M&A activity, restructuring, IPO process, board changes, or distress.","parameters":[{"name":"days","in":"query","schema":{"type":"integer","default":30,"maximum":365}},{"name":"family","in":"query","schema":{"type":"string","description":"form_type_family filter (e.g. current_report, periodic, insider)"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/upcoming-earnings":{"get":{"tags":["sec.filings"],"summary":"Predict upcoming 10-Q/10-K filings from historical cadence","description":"Heuristic: gap between the most recent two filings of the same form ≈ gap to the next one. Companies do change cadence so this is approximate.","parameters":[{"name":"within_days","in":"query","schema":{"type":"integer","default":30,"maximum":120}},{"name":"form_type","in":"query","schema":{"type":"string","enum":["10-Q","10-K"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/8k/by-item":{"get":{"tags":["sec.filings"],"summary":"8-K filings filtered by item code (5.02 director departures, 1.01 M&A, 4.02 restatements, etc.)","description":"Returns 8-K filings whose parsed body has a section matching the requested item. Coverage limited by the 8-K body-extraction backlog. Item code can be 5.02, item-5-02, or 5-02 — normalized internally.","parameters":[{"name":"item","in":"query","required":true,"schema":{"type":"string","example":"5.02"}},{"name":"ticker","in":"query","schema":{"type":"string","description":"Filter to one company"}},{"name":"days","in":"query","schema":{"type":"integer","default":30,"maximum":365}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/13d-positions/recent":{"get":{"tags":["sec.holdings"],"summary":"Structured Schedule 13D/G positions — parsed from primary_doc.xml","description":"Returns structured rows with target CUSIP, ticker, aggregate shares, percent of class. Newer 13D/G filings use a standardized XML schema; older HTML filings are best-effort regex-parsed.","parameters":[{"name":"days","in":"query","schema":{"type":"integer","default":90,"maximum":365}},{"name":"min_percent","in":"query","schema":{"type":"number","description":"Filter to positions above N% of class"}},{"name":"filer_cik","in":"query","schema":{"type":"string"}},{"name":"filer","in":"query","schema":{"type":"string","description":"Filer ticker shorthand"}},{"name":"target_cusip","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/13dg/recent":{"get":{"tags":["sec.holdings"],"summary":"Recent Schedule 13D/G filings (activist + passive >5% holder positions)","description":"13D = activist intent, 13G = passive >5% holder, /A = amendment. Structured target/% extraction is TBD; this metadata view links to edgar_url.","parameters":[{"name":"days","in":"query","schema":{"type":"integer","default":30,"maximum":365}},{"name":"type","in":"query","schema":{"type":"string","enum":["13D","13G"]}},{"name":"filer_cik","in":"query","schema":{"type":"string"}},{"name":"issuer","in":"query","schema":{"type":"string","description":"Ticker or CIK best-effort match"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/upcoming-sales-pressure":{"get":{"tags":["sec.insider"],"summary":"Aggregate Form 144 sale pressure — companies with the most upcoming insider sales","description":"Forward-looking aggregation of Form 144 notices. Default groups by issuer; pass group_by=seller to find the most active sellers.","parameters":[{"name":"days","in":"query","schema":{"type":"integer","default":30,"maximum":180}},{"name":"group_by","in":"query","schema":{"type":"string","enum":["issuer","seller"],"default":"issuer"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/form144/brokers":{"get":{"tags":["sec.insider"],"summary":"Broker leaderboard from Form 144 — who's handling the most insider sale notices","parameters":[{"name":"days","in":"query","schema":{"type":"integer","default":30,"maximum":180}},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":100}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/form144/recent":{"get":{"tags":["sec.insider"],"summary":"Recent Form 144 notices — predictive insider-sale signal","description":"Filed before an affiliate sells restricted or control stock. Tracks seller, relationship, quantity, $, planned sale date. Complementary to Form 4 (post-trade).","parameters":[{"name":"days","in":"query","schema":{"type":"integer","default":7,"maximum":90}},{"name":"min_usd","in":"query","schema":{"type":"number"}},{"name":"limit","in":"query","schema":{"type":"integer","default":100,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/companies/{cik_or_ticker}/risk-flags":{"get":{"tags":["sec.companies"],"summary":"Multi-source red-flag detector for one company","description":"Combines 8-K item parses (4.02 restatements, 4.01 auditor changes, 5.02 officer departures), insider cluster sells, Form 144 upcoming-sale pressure, Schedule 13D filings, FDA recalls against the firm, and FAERS adverse-event volume into one ranked flags array. Empty array = no red flags.","parameters":[{"name":"cik_or_ticker","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/companies/{cik_or_ticker}/insider-network":{"get":{"tags":["sec.insider"],"summary":"Other companies sharing insiders with this one (interlocking directorates)","description":"Surfaces board interlock, multi-company executives, and activist-investor portfolio overlap by joining Form 4 reporting_owner_name across companies.","parameters":[{"name":"cik_or_ticker","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":100}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/companies/{cik_or_ticker}/officers":{"get":{"tags":["sec.insider"],"summary":"Known officers/directors of one company, from Form 4 + Form 144","description":"Distinct named persons who've transacted or filed a sale notice. Not a complete roster — only people active in the data. Complete officer list requires DEF 14A parsing.","parameters":[{"name":"cik_or_ticker","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":30,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/companies/{cik_or_ticker}/derivatives":{"get":{"tags":["sec.insider"],"summary":"Derivative-security transactions (RSU grants, option exercises, tax-withholding)","description":"Most insider endpoints filter these out. This view surfaces them so agents can answer 'what stock awards has this executive received?' price_per_share here is the option strike/cost basis, not the stock price.","parameters":[{"name":"cik_or_ticker","in":"path","required":true,"schema":{"type":"string"}},{"name":"days","in":"query","schema":{"type":"integer","default":180,"maximum":730}},{"name":"limit","in":"query","schema":{"type":"integer","default":100,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/companies/{cik_or_ticker}/insider-pulse":{"get":{"tags":["sec.insider"],"summary":"Unified insider timeline — Form 4 trades + Form 144 proposed-sale notices","description":"Returns a single time-ordered feed for the company. Each event has kind=form4 (executed) or kind=form144 (notice of proposed sale). Tally section gives quick summary stats.","parameters":[{"name":"cik_or_ticker","in":"path","required":true,"schema":{"type":"string"}},{"name":"days","in":"query","schema":{"type":"integer","default":90,"maximum":365}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/companies/{cik_or_ticker}/form144":{"get":{"tags":["sec.insider"],"summary":"Form 144 notices for one company","parameters":[{"name":"cik_or_ticker","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/insider-dashboard":{"get":{"tags":["sec.insider"],"summary":"One-call cross-company insider snapshot — cluster buys/sells + biggest trades + 144 pressure + weekly trend","description":"Saves agents from 4-5 separate calls when they just want 'what's happening with insiders today'.","parameters":[{"name":"days","in":"query","schema":{"type":"integer","default":30,"maximum":90}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/insider-trends":{"get":{"tags":["sec.insider"],"summary":"Insider buy/sell time-series — daily/weekly/monthly aggregates","description":"Open-market Form 4 transactions only (codes P, S), non-derivative, deduped per (txn × all reporters). Returns net_usd = bought_usd - sold_usd per bucket.","parameters":[{"name":"days","in":"query","schema":{"type":"integer","default":90,"maximum":730}},{"name":"bucket","in":"query","schema":{"type":"string","enum":["day","week","month"],"default":"week"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/cluster-sells":{"get":{"tags":["sec.insider"],"summary":"Companies where multiple insiders sold stock in the same window (open-market sales only)","description":"Form 4 code S, non-derivative. Weaker signal than cluster-buys but spots mass insider exits.","parameters":[{"name":"days","in":"query","schema":{"type":"integer","default":30,"maximum":365}},{"name":"min_insiders","in":"query","schema":{"type":"integer","default":3,"minimum":2}},{"name":"min_usd","in":"query","schema":{"type":"number"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/cluster-buys":{"get":{"tags":["sec.insider"],"summary":"Companies where multiple insiders bought stock in the same window (open-market purchases only)","description":"Form 4 code P, non-derivative. Classic conviction signal — insiders typically buy only when expecting upside.","parameters":[{"name":"days","in":"query","schema":{"type":"integer","default":90,"maximum":365}},{"name":"min_insiders","in":"query","schema":{"type":"integer","default":3,"minimum":2}},{"name":"min_usd","in":"query","schema":{"type":"number"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/insider-transactions/recent":{"get":{"tags":["sec.insider"],"summary":"Cross-company recent insider transactions","parameters":[{"name":"days","in":"query","schema":{"type":"integer","default":7,"maximum":90}},{"name":"min_usd","in":"query","schema":{"type":"number"}},{"name":"code","in":"query","schema":{"type":"string","description":"Transaction code (P, S, etc.)"}},{"name":"limit","in":"query","schema":{"type":"integer","default":100,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/companies/{cik_or_ticker}/holdings":{"get":{"tags":["sec.holdings"],"summary":"13F holdings of this filer (their portfolio)","parameters":[{"name":"cik_or_ticker","in":"path","required":true,"schema":{"type":"string"}},{"name":"period","in":"query","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","schema":{"type":"integer","default":200,"maximum":5000}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/funds/largest-positions":{"get":{"tags":["sec.holdings"],"summary":"Largest single positions across the mutual-fund universe (NPORT-P)","description":"Surfaces concentrated positions and mega-stakes. Filter by min_pct for concentrated bets, min_value_usd for mega-stakes.","parameters":[{"name":"min_pct","in":"query","schema":{"type":"number","description":"Minimum % of fund net assets"}},{"name":"min_value_usd","in":"query","schema":{"type":"number"}},{"name":"period","in":"query","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/fda/labels/recent":{"get":{"tags":["fda.recalls"],"summary":"Recent FDA drug labels (Structured Product Labeling)","parameters":[{"name":"product_type","in":"query","schema":{"type":"string","description":"e.g., 'HUMAN PRESCRIPTION DRUG'"}},{"name":"manufacturer","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/fda/labels/{name}":{"get":{"tags":["fda.recalls"],"summary":"FDA drug-label lookup by brand, generic, or substance name","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","description":"Substring match — e.g. 'aspirin' or 'COSENTYX'"}}],"responses":{"200":{"description":"OK with indications, dosage, warnings, adverse reactions, etc."}}}},"/api/v1/fda/firms/{name}":{"get":{"tags":["fda.recalls"],"summary":"All FDA activity for one firm — recalls + 510(k) clearances + adverse events","description":"Firm-level dossier. Recalls match on recalling_firm, clearances on applicant, adverse events on patient_drugs_json (best-effort).","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","description":"URL-encoded firm name substring (e.g., Pfizer)"}},{"name":"days","in":"query","schema":{"type":"integer","default":365,"maximum":1825}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/funds/{cik_or_series_id}/breakdown":{"get":{"tags":["sec.holdings"],"summary":"Mutual fund's asset/issuer/country breakdown","description":"Groups one NPORT-P fund's holdings into pct-of-portfolio buckets by asset_category (EC equity / DBT debt / STIV short-term), issuer_category (CORP / MUN / UST / RF fund-of-funds), and investment_country.","parameters":[{"name":"cik_or_series_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"period","in":"query","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/funds/{cik_or_series_id}/holdings":{"get":{"tags":["sec.holdings"],"summary":"Holdings of one mutual fund (NPORT-P)","description":"Pass a 10-digit CIK (entire fund family) or a series_id like S000012345 (one fund). Latest report period by default.","parameters":[{"name":"cik_or_series_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"period","in":"query","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","schema":{"type":"integer","default":200,"maximum":2000}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/securities/{cusip}/fund-holders":{"get":{"tags":["sec.holdings"],"summary":"Mutual funds (NPORT-P) holding a security by CUSIP","description":"Parallel to /top-holders (which uses 13F institutional data). NPORT-P covers mutual-fund holdings.","parameters":[{"name":"cusip","in":"path","required":true,"schema":{"type":"string"}},{"name":"period","in":"query","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/securities/{cusip}/top-holders":{"get":{"tags":["sec.holdings"],"summary":"Top 13F holders of a given security (by CUSIP)","parameters":[{"name":"cusip","in":"path","required":true,"schema":{"type":"string"}},{"name":"period","in":"query","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/13f/recent":{"get":{"tags":["sec.holdings"],"summary":"Recent 13F filings grouped by filer","parameters":[{"name":"period","in":"query","schema":{"type":"string","format":"date"}},{"name":"min_aum","in":"query","schema":{"type":"number"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/companies/{cik_or_ticker}/timeline":{"get":{"tags":["sec.companies"],"summary":"Chronological event timeline (filings + insider transactions, mixed)","parameters":[{"name":"cik_or_ticker","in":"path","required":true,"schema":{"type":"string"}},{"name":"days","in":"query","schema":{"type":"integer","default":30,"maximum":365}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/clinical/recent":{"get":{"tags":["clinical"],"summary":"Recent clinical trial updates from ClinicalTrials.gov","parameters":[{"name":"phase","in":"query","schema":{"type":"string","enum":["PHASE1","PHASE2","PHASE3","PHASE4","NA"]}},{"name":"status","in":"query","schema":{"type":"string"},"description":"RECRUITING / ACTIVE_NOT_RECRUITING / COMPLETED / TERMINATED / WITHDRAWN / SUSPENDED"},{"name":"sponsor","in":"query","schema":{"type":"string"},"description":"Substring filter on lead sponsor"},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/clinical/{nctId}":{"get":{"tags":["clinical"],"summary":"Single clinical trial detail by NCT ID","parameters":[{"name":"nctId","in":"path","required":true,"schema":{"type":"string"},"example":"NCT05123456"}],"responses":{"200":{"description":"OK"},"404":{"description":"Not found"}}}},"/api/v1/lobbying/recent":{"get":{"tags":["lobbying"],"summary":"Recent Senate Lobbying Disclosure filings","parameters":[{"name":"client","in":"query","schema":{"type":"string"},"description":"Substring filter on client company name"},{"name":"year","in":"query","schema":{"type":"integer"}},{"name":"issue","in":"query","schema":{"type":"string"},"description":"3-letter issue code (PHA, HCR, TAX, DEF, ENG, ...)"},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/lobbying/by-client/{client}":{"get":{"tags":["lobbying"],"summary":"Aggregate lobbying dossier for one client (total spend, top issues, recent filings)","parameters":[{"name":"client","in":"path","required":true,"schema":{"type":"string"},"example":"Pfizer"}],"responses":{"200":{"description":"OK"}}}},"/api/v1/epa/facilities":{"get":{"tags":["epa"],"summary":"EPA-regulated facilities, filterable by owner / state / violations","parameters":[{"name":"owner","in":"query","schema":{"type":"string"},"description":"Substring on owner_org_name"},{"name":"state","in":"query","schema":{"type":"string"},"description":"2-letter state code"},{"name":"violations","in":"query","schema":{"type":"integer","enum":[0,1]},"description":"Set =1 to only show facilities with violations"},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/epa/facilities/{frsId}":{"get":{"tags":["epa"],"summary":"Single EPA facility detail by FRS Registry ID","parameters":[{"name":"frsId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Not found"}}}},"/api/v1/patents/recent":{"get":{"tags":["patents"],"summary":"Recent USPTO patent grants from PatentsView","parameters":[{"name":"assignee","in":"query","schema":{"type":"string"},"description":"Substring on primary_assignee"},{"name":"cpc","in":"query","schema":{"type":"string"},"description":"CPC subclass prefix (A61K, G06N, etc.)"},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/patents/by-assignee/{name}":{"get":{"tags":["patents"],"summary":"Aggregate patent dossier for one company (total grants, top CPC classes, recent grants)","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"},"example":"Pfizer"}],"responses":{"200":{"description":"OK"}}}},"/api/v1/patents/{patentId}":{"get":{"tags":["patents"],"summary":"Single USPTO patent detail","parameters":[{"name":"patentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/courts/recent":{"get":{"tags":["courts"],"summary":"Recent federal court dockets from CourtListener (filterable by party, NOS, court)","parameters":[{"name":"party","in":"query","schema":{"type":"string"},"description":"Defendant/plaintiff substring"},{"name":"nos","in":"query","schema":{"type":"string"},"description":"Nature of Suit code: 850, 830, 410, 365, 367, 480"},{"name":"court","in":"query","schema":{"type":"string"},"description":"Court ID e.g. 'cacd', 'mad'"},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/courts/by-party/{name}":{"get":{"tags":["courts"],"summary":"Litigation dossier for one company (docket count, NOS breakdown, recent cases)","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/courts/{docketId}":{"get":{"tags":["courts"],"summary":"Single court docket detail with parties + procedural metadata","parameters":[{"name":"docketId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sanctions/check":{"get":{"tags":["sanctions"],"summary":"Check if a name appears on the US Treasury OFAC SDN list (matches primary names + AKA/FKA aliases)","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"},"example":"Acme Trading"}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sanctions/recent":{"get":{"tags":["sanctions"],"summary":"Recent OFAC sanctioned entities, filterable by program (RUSSIA-EO14024, SDGT, CYBER2, etc.)","parameters":[{"name":"program","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string","enum":["Individual","Entity","Vessel","Aircraft"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/cfpb/recent":{"get":{"tags":["cfpb"],"summary":"Recent CFPB consumer complaints (banking, credit cards, mortgages, debt collection)","parameters":[{"name":"company","in":"query","schema":{"type":"string"}},{"name":"product","in":"query","schema":{"type":"string"}},{"name":"state","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/cfpb/by-company/{name}":{"get":{"tags":["cfpb"],"summary":"CFPB consumer complaint dossier for one financial firm","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/nih/recent":{"get":{"tags":["nih"],"summary":"Recent NIH RePORTER grant records (R01, R21, P01, SBIR, etc.)","parameters":[{"name":"org","in":"query","schema":{"type":"string"}},{"name":"activity","in":"query","schema":{"type":"string"},"description":"R01, R21, P01, SBIR, STTR, etc."},{"name":"fy","in":"query","schema":{"type":"integer"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/nih/by-org/{name}":{"get":{"tags":["nih"],"summary":"NIH grant dossier for one organization (total funding, top activity codes, recent grants)","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/osha/recent":{"get":{"tags":["osha"],"summary":"Recent OSHA workplace-injury filings (Form 300A annual summaries)","parameters":[{"name":"company","in":"query","schema":{"type":"string"}},{"name":"state","in":"query","schema":{"type":"string"}},{"name":"year","in":"query","schema":{"type":"integer"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/osha/by-company/{name}":{"get":{"tags":["osha"],"summary":"OSHA injury-rate dossier for one company (per establishment + per state breakdown)","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/fed-enforcement/recent":{"get":{"tags":["fed-enforcement"],"summary":"Federal Reserve enforcement actions (consent orders, CMPs, removals)","parameters":[{"name":"bank","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/nhtsa/recent":{"get":{"tags":["nhtsa"],"summary":"Recent NHTSA vehicle recalls (auto regulator). park_it=1 returns only do-not-drive recalls.","parameters":[{"name":"manufacturer","in":"query","schema":{"type":"string"}},{"name":"make","in":"query","schema":{"type":"string"}},{"name":"year","in":"query","schema":{"type":"integer"}},{"name":"park_it","in":"query","schema":{"type":"integer","enum":[0,1]}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/nhtsa/by-manufacturer/{name}":{"get":{"tags":["nhtsa"],"summary":"NHTSA recall dossier for one auto OEM (recall count, top affected components, recent recalls)","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/doj/recent":{"get":{"tags":["doj"],"summary":"Recent DOJ press releases (FCPA, antitrust, healthcare fraud, environmental, civil rights)","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Free-text substring in title or body"},{"name":"component","in":"query","schema":{"type":"string"},"description":"DOJ component name substring"},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/doj/by-company/{name}":{"get":{"tags":["doj"],"summary":"DOJ press releases mentioning one company (FCPA, antitrust, healthcare fraud, etc.)","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/debarments/check":{"get":{"tags":["debarments"],"summary":"Screen a name across SAM federal-contractor + HHS OIG healthcare exclusion lists","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sam-exclusions/recent":{"get":{"tags":["debarments"],"summary":"Recent SAM federal-contractor exclusions (debarred from receiving federal contracts)","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/oig-exclusions/recent":{"get":{"tags":["debarments"],"summary":"Recent HHS OIG healthcare-provider exclusions (barred from billing Medicare/Medicaid)","parameters":[{"name":"state","in":"query","schema":{"type":"string"}},{"name":"field","in":"query","schema":{"type":"string"},"description":"Provider field (substring): PHYSICIAN, RN, OTHER BUSINESS, etc."},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/cisa/kev/recent":{"get":{"tags":["cisa"],"summary":"Recent CISA Known Exploited Vulnerabilities. Filter by vendor or ransomware flag.","parameters":[{"name":"vendor","in":"query","schema":{"type":"string"}},{"name":"ransomware","in":"query","schema":{"type":"string","enum":["Known","Unknown"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/cisa/kev/by-vendor/{name}":{"get":{"tags":["cisa"],"summary":"CISA KEV dossier for one tech vendor (CVE count, ransomware-known count, recent CVEs)","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/nsf/recent":{"get":{"tags":["nsf"],"summary":"Recent NSF Awards. Filter by awardee, state, program.","parameters":[{"name":"awardee","in":"query","schema":{"type":"string"}},{"name":"state","in":"query","schema":{"type":"string"}},{"name":"program","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/nsf/by-org/{name}":{"get":{"tags":["nsf"],"summary":"NSF Awards dossier for one organization (total funding, top programs, recent awards)","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/cross-vertical/active":{"get":{"tags":["entity"],"summary":"Entities with activity in 2+ regulatory verticals — discovery feed for the cross-vertical timeline","parameters":[{"name":"days","in":"query","schema":{"type":"integer","default":90,"maximum":365}},{"name":"min_verticals","in":"query","schema":{"type":"integer","default":2,"minimum":2,"maximum":4}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/entity/{key}/timeline":{"get":{"tags":["entity"],"summary":"Cross-vertical entity timeline — merges SEC filings, insider trades, Form 144, Schedule 13D, FDA recalls, FDA drug labels, federal contracts into one ordered feed","description":"Resolves `key` against entity_master (ticker, CIK, UEI, LEI, DUNS, or numeric entity_id) and joins against entity_alias to pull events across every vertical the entity appears in.","parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"},"example":"AAPL"},{"name":"days","in":"query","schema":{"type":"integer","default":180,"maximum":730}},{"name":"limit","in":"query","schema":{"type":"integer","default":100,"maximum":500}},{"name":"min_importance","in":"query","schema":{"type":"number","default":0,"description":"Filter to events scoring at or above this. Reference: Class I recall=100, 13D=75, large Form 144=75, insider buy=50, 8-K=35."}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/entity/{key}/material-events":{"get":{"tags":["entity"],"summary":"Material events only — entity timeline pre-filtered to min_importance=60","description":"Convenience shortcut: returns only events scoring 60 or above (Class I FDA recalls, Schedule 13D filings, large Form 144 notices, insider purchases). The 'alert me' feed.","parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"},"example":"BSX"},{"name":"days","in":"query","schema":{"type":"integer","default":180,"maximum":730}},{"name":"limit","in":"query","schema":{"type":"integer","default":100,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/financial-facts/by-concept":{"get":{"tags":["sec.financials"],"summary":"Top N companies by a single XBRL metric","parameters":[{"name":"concept","in":"query","required":true,"schema":{"type":"string"},"example":"NetIncomeLoss"},{"name":"period","in":"query","schema":{"type":"string","default":"FY"}},{"name":"fiscal_year","in":"query","schema":{"type":"integer"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}},{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/industries":{"get":{"tags":["sec.companies"],"summary":"SIC-grouped industries — counts + example tickers, or filter by SIC / keyword","parameters":[{"name":"sic","in":"query","schema":{"type":"string"},"description":"4-digit SIC code"},{"name":"keyword","in":"query","schema":{"type":"string"},"description":"Substring on industry description"},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/securities/search":{"get":{"tags":["sec.companies"],"summary":"Unified security search: name, ticker, or CUSIP","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"example":"nvidia"},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":200}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/news":{"get":{"tags":["discovery"],"summary":"Time-ordered cross-topic news (insider, recalls, weather, presidential docs, 8-Ks, cluster buys, 13D)","description":"Response includes 'available_kinds' listing every kind you can pass to ?kind=.","parameters":[{"name":"days","in":"query","schema":{"type":"integer","default":3,"maximum":30}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}},{"name":"kind","in":"query","schema":{"type":"string","description":"Comma-separated allow-list (e.g. cluster_buy,form144,schedule_13d_new)"}},{"name":"topic","in":"query","schema":{"type":"string","description":"Filter to one topic (sec / fda / weather / register / climate)"}},{"name":"min_importance","in":"query","schema":{"type":"number","description":"Filter to high-signal events only. Reference: cluster_buy=85, presidential=80, 13D_new=75, alert_severe=60, 8k=30, Class I recall=100"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/help":{"get":{"tags":["discovery"],"summary":"Question → URL catalog for AI assistants","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Substring filter"}],"responses":{"200":{"description":"OK"}}}},"/api/v1/glossary":{"get":{"tags":["discovery"],"summary":"Lookup SEC/FDA/weather/register abbreviations","parameters":[{"name":"term","in":"query","schema":{"type":"string"},"example":"10-K"}],"responses":{"200":{"description":"OK"}}}},"/api/v1/agent-stats":{"get":{"tags":["discovery"],"summary":"Self-introspection — who's using this hub, by agent_source","parameters":[{"name":"days","in":"query","schema":{"type":"integer","default":7,"maximum":90}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/coverage":{"get":{"tags":["discovery"],"summary":"Operations snapshot — recent ingestion runs, queue depth, parse errors, freshness","responses":{"200":{"description":"OK"}}}},"/api/v1/dossier":{"get":{"tags":["discovery"],"summary":"Cross-topic entity lookup — name → matches across SEC + FDA + Register + Contracts + 13F","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"},"example":"Pfizer"}],"responses":{"200":{"description":"OK"}}}},"/api/v1/climate/earthquakes/recent":{"get":{"tags":["climate"],"summary":"Recent USGS earthquakes (worldwide)","parameters":[{"name":"min_mag","in":"query","schema":{"type":"number","default":4}},{"name":"days","in":"query","schema":{"type":"integer","default":14,"maximum":90}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/sec/companies/{cik_or_ticker}/financial-facts":{"get":{"tags":["sec.financials"],"summary":"XBRL financial facts (revenue, EPS, net income, etc.)","parameters":[{"name":"cik_or_ticker","in":"path","required":true,"schema":{"type":"string"}},{"name":"concept","in":"query","schema":{"type":"string"},"example":"NetIncomeLoss"},{"name":"period","in":"query","schema":{"type":"string","enum":["FY","Q1","Q2","Q3","Q4"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":40,"maximum":400}}],"responses":{"200":{"description":"Without concept: summary of latest values. With concept: full history."}}}},"/api/v1/sec/compare":{"get":{"tags":["sec.financials"],"summary":"Side-by-side financials for up to 10 companies","parameters":[{"name":"tickers","in":"query","required":true,"schema":{"type":"string"},"example":"AAPL,MSFT,GOOGL"},{"name":"concept","in":"query","schema":{"type":"string"},"description":"Single metric to compare; omit for default basket"},{"name":"period","in":"query","schema":{"type":"string","default":"FY"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/register/recent":{"get":{"tags":["register"],"summary":"Recent Federal Register documents (rules, proposed rules, notices, presidential docs)","parameters":[{"name":"type","in":"query","schema":{"type":"string","enum":["Rule","Proposed Rule","Notice","Presidential Document"]}},{"name":"agency","in":"query","schema":{"type":"string"},"description":"Substring match on first agency name"},{"name":"days","in":"query","schema":{"type":"integer","default":30,"maximum":365}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/register/executive-orders":{"get":{"tags":["register"],"summary":"Executive Orders (Presidential Documents with EO number)","responses":{"200":{"description":"OK"}}}},"/sec/{ticker_or_cik}/{form}/{period}/{section}":{"get":{"tags":["sec.sections"],"summary":"Filing section body (shadow-billed for AI crawlers)","description":"Returns the parsed body of a specific filing section. Currently free for all callers; AI-crawler hits are logged with price_micros=1000 (the shadow price) in agent_query_log. Real Pay Per Crawl will be enabled when DNS moves to a CF zone. Append .md, .html, or .json to control format (default: JSON envelope).","parameters":[{"name":"ticker_or_cik","in":"path","required":true,"schema":{"type":"string"},"example":"useg"},{"name":"form","in":"path","required":true,"schema":{"type":"string"},"example":"8-k"},{"name":"period","in":"path","required":true,"schema":{"type":"string"},"example":"2026-05-08"},{"name":"section","in":"path","required":true,"schema":{"type":"string"},"example":"item-5-02"}],"responses":{"200":{"description":"Section body (markdown/html/json)"},"404":{"description":"Section not found"}}}},"/fda/{product}/recalls/{recall_number}":{"get":{"tags":["fda.recalls"],"summary":"FDA recall detail (drug/device/food)","parameters":[{"name":"product","in":"path","required":true,"schema":{"type":"string","enum":["drug","device","food"]}},{"name":"recall_number","in":"path","required":true,"schema":{"type":"string"},"example":"D-0500-2026"}],"responses":{"200":{"description":"Recall summary (markdown or JSON envelope)"}}}},"/api/v1/fda/stats":{"get":{"tags":["fda.recalls"],"summary":"FDA aggregate counts","responses":{"200":{"description":"OK"}}}},"/api/v1/fda/recalls/recent":{"get":{"tags":["fda.recalls"],"summary":"Recent FDA enforcement actions (recalls)","parameters":[{"name":"product","in":"query","schema":{"type":"string","enum":["drug","device","food"]}},{"name":"class","in":"query","schema":{"type":"string","enum":["Class I","Class II","Class III"]}},{"name":"firm","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string","enum":["Ongoing","Completed","Terminated"]}},{"name":"days","in":"query","schema":{"type":"integer","default":30,"maximum":365}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":500}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/fda/adverse-events/recent":{"get":{"tags":["fda.adverse"],"summary":"Recent FAERS adverse event reports","parameters":[{"name":"days","in":"query","schema":{"type":"integer","default":30,"maximum":365}},{"name":"drug","in":"query","schema":{"type":"string"},"example":"COSENTYX"},{"name":"reaction","in":"query","schema":{"type":"string"},"example":"Pneumonia"},{"name":"serious","in":"query","schema":{"type":"string","enum":["1"]}},{"name":"outcome","in":"query","schema":{"type":"string","enum":["death","hospitalization","lifethreatening","disabling"]}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/fda/510k/recent":{"get":{"tags":["fda.510k"],"summary":"Recent FDA 510(k) medical device clearances","parameters":[{"name":"days","in":"query","schema":{"type":"integer","default":30,"maximum":365}},{"name":"applicant","in":"query","schema":{"type":"string"},"example":"Medtronic"},{"name":"product_code","in":"query","schema":{"type":"string"}},{"name":"decision","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}}},"components":{"parameters":{"State":{"name":"state","in":"query","required":true,"description":"Exact uppercase two-letter source state; never inferred from NCIC.","schema":{"type":"string","pattern":"^[A-Z]{2}$"}},"Ncic":{"name":"ncic","in":"path","required":true,"description":"Exact uppercase 6-12 character source NCIC.","schema":{"type":"string","pattern":"^[A-Z0-9]{6,12}$"}},"FiscalYear":{"name":"fiscal_year","in":"query","required":true,"schema":{"type":"integer","minimum":1900,"maximum":2200}},"FiscalYearOptional":{"name":"fiscal_year","in":"query","required":false,"schema":{"type":"integer","minimum":1900,"maximum":2200}},"Limit":{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},"Cursor":{"name":"cursor","in":"query","required":false,"description":"Opaque HMAC-authenticated cursor bound to manifest content and exact filters.","schema":{"type":"string","maxLength":2048}}},"schemas":{"EquitableSharingEnvelope":{"type":"object","additionalProperties":false,"required":["schema_version","dataset","snapshot","caveats","query","data"],"properties":{"schema_version":{"const":"doj-equitable-sharing-api.v1"},"dataset":{"const":"DOJ Equitable Sharing Agreement and Certification (ESAC)"},"snapshot":{"type":"object","required":["snapshot_id","manifest_sha256","source_data_as_of","source_age_days","freshness_status"],"properties":{"snapshot_id":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}-[0-9a-f]{16}$"},"manifest_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"source_data_as_of":{"type":"string","format":"date"},"source_age_days":{"type":"integer","minimum":0},"freshness_status":{"const":"stale_source_snapshot"}}},"caveats":{"type":"object","minProperties":6},"query":{"type":"object"},"data":{},"page":{"type":"object"}}},"EquitableSharingError":{"type":"object","additionalProperties":false,"required":["schema_version","error","caveats"],"properties":{"schema_version":{"const":"doj-equitable-sharing-api.v1"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"caveats":{"type":"object","minProperties":6}}}}},"x-equitable-sharing-omitted-endpoint-classes":["fuzzy or name search","people or contact records","case, seizure, claim, petition, or asset records","CATS records"],"x-equitable-sharing-required-response-caveats":["dated stale source snapshot","agency-reported amounts","top-level status is not a misconduct finding","overall agency budget is not forfeiture money","null and zero remain distinct"]}