Step-by-step setup for surveilling every regulatory event (SEC, FDA, courts, contracts, enforcement) for a portfolio of companies, in one request per company.
Maintain your list of tickers, CIKs, UEIs, or entity_ids — whatever you have. The /entity/{key} endpoint accepts any of them and joins via the entity_master bridge table.
For each ticker:
GET /api/v1/entity/{ticker}/material-events?days=7
Returns only events with importance ≥ 60 in the last 7 days. Typical signals:
Page on:
importance ≥ 80/api/v1/screening/all?ticker=… weekly)Each event includes an accession_number — track which you've seen to dedupe.
Independent of your watchlist, use /today.json for an on-request, UTC source-date-bounded digest aggregating:
The response publishes its generation time and window. Check /api/v1/freshness before treating absence as proof that no event occurred. HTML view: /today.