Query the stream of normalized, evidence-backed SEC business-change events — new filings, leadership and auditor changes, insider sells, Form D raises, and more.

Events feed

Clous turns raw SEC filings into normalized business-change events — each one typed, scored for importance, and attached to evidence (source URL, excerpt, section, hash). The feed is the same stream your monitors match against; query it directly to backfill or build your own routing.

Base URL: https://api.clous.ai
Auth: Authorization: Bearer clous_live_...

List events

GET /v1/events

Returns events newest-first through the standard envelope, cursor-paginated.

Query parameters

Prop

Type

Example request

curl -s "https://api.clous.ai/v1/events?event_type=sec.filing.new&limit=2" \
  -H "Authorization: Bearer clous_live_..."

import requests
resp = requests.get(
    "https://api.clous.ai/v1/events",
    params={"event_type": "sec.filing.new", "limit": 2},
    headers={"Authorization": "Bearer clous_live_..."},
)
events = resp.json()["data"]

Example response

{
  "data": [
    {
      "id": "535754cd-1b29-4bb9-8281-3e87d93b950e",
      "event_type": "sec.filing.new",
      "importance": "medium",
      "confidence": 1,
      "entity_cik": "0001959244",
      "entity_ticker": null,
      "entity_name": "Hoots Cindy L",
      "accession": "0001585521-26-000088",
      "summary": "Hoots Cindy L filed a 4.",
      "details": { "form": "4" },
      "evidence": [
        {
          "source_type": "sec_filing",
          "url": "https://www.sec.gov/Archives/edgar/data/1959244/000158552126000088/0001585521-26-000088-index.htm",
          "retrieved_at": "2026-06-13T14:52:50.615692+00:00"
        }
      ],
      "dedup_key": "sec.filing.new|0001585521-26-000088",
      "detected_at": "2026-06-13T14:52:50.700110+00:00"
    }
  ],
  "page": { "limit": 2, "next_cursor": "…", "has_more": true },
  "as_of": "2026-06-13T14:55:00Z",
  "source": "clous_events",
  "query_echo": { "event_type": "sec.filing.new" },
  "warnings": []
}

Every event carries the resolved entity (entity_cik / entity_ticker / entity_name), an importance (high / medium / low), a one-line summary, structured details, and an evidence[] array so you can verify the source. dedup_key makes the feed idempotent.

Get one event

GET /v1/events/{event_id}

Returns a single event with its full evidence.

Event taxonomy

Event types are stable and namespaced. The SEC namespace today:

Namespace	Event types
`sec.filing.*`	`sec.filing.new`, `sec.filing.amended`
`sec.8k.*`	`sec.8k.material_agreement`, `sec.8k.executive_change`, `sec.8k.auditor_change`, `sec.8k.bankruptcy_or_receivership`, `sec.8k.results_of_operations`, `sec.8k.cybersecurity_incident`, `sec.8k.delisting_notice`
`sec.10k.* / 10q.*`	`sec.10k.risk_factor_changed`, `sec.10k.mda_changed`, `sec.10q.mda_changed`
`sec.form4.*`	`sec.form4.insider_buy`, `sec.form4.insider_sell`, `sec.form4.option_exercise`
`sec.13f.*`	`sec.13f.position_increased`, `sec.13f.position_decreased`, `sec.13f.holding_added`, `sec.13f.holding_removed`
`sec.formd.*`	`sec.formd.new_offering`, `sec.formd.offering_amended`
`sec.s1.* / proxy.*`	`sec.s1.new_registration`, `sec.s1.amended_registration`, `sec.proxy.board_changed`, `sec.proxy.executive_compensation_changed`

To get a webhook the moment one of these fires for a company you care about, create a monitor.

Notes

Events derive from public SEC EDGAR filings; Clous is independent of the SEC.
The feed is append-only and idempotent (dedup_key); the same filing never produces a duplicate event.
confidence is 1.0 for deterministic, filing-derived events.

Events feed

On this page