Step-by-step setup for reviewing supported dated public records (SEC, FDA, courts, contracts, enforcement) for a portfolio, 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 supported dated records with importance ≥ 60, from seven UTC calendar days ago through today (inclusive). The window uses each source event date, not when MORVS first observed the record. Annual aggregates and undated snapshots are excluded.
Historical corrections and late ingests can appear after their source-date window has passed. Check /api/v1/freshness and keep your own first-seen log before treating this as an alert feed.
Typical signals:
Review candidates:
importance ≥ 80/api/v1/screening/all?ticker=… weekly)Track source and accession_number in your own first-seen log to dedupe. The timeline does not establish when MORVS first received a historical record; verify source freshness before paging automatically.
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.