Developers

API & MCP reference

Base URL https://filings.dropwatchhq.com. Auth via x-api-key header or ?key=. No key = free tier (fresh-filing sample, limited results).

1 · whats_new_since the lock-in

Returns fresh filings since your cursor. Store the returned cursor and pass it back next time — that's your bookmark, and your switching cost.

GET /v1/whats_new_since
  ?cursor=<opaque, omit for first call>
  &form=8-K,4         # comma-separated form types
  &ticker=AAPL        # exact ticker
  &cik=0000320193     # exact CIK
  &item=5.02          # 8-K item code
  &minEventScore=5    # severity floor (material events only)
  &limit=200

# response
{ "filings":[ {"form":"8-K","filingDate":"2026-06-21","company":"...","cik":"...",
    "topItem":"4.02","topLabel":"Non-Reliance on Prior Financials (restatement)",
    "eventScore":10,"url":"https://www.sec.gov/Archives/edgar/..."} ],
  "cursor":"c1_...", "throughDate":"2026-06-21", "snapshotCount": 1 }

2 · filing_digest

Material 8-K events + insider (Form 4) activity + new registrations over the last N days, for a filter.

GET /v1/filing_digest?ticker=AAPL&days=7

3 · company_watch

Recent filings, insider activity, and filing-velocity for one company (by CIK). Live-backfilled from EDGAR, so it works day one.

GET /v1/company_watch?cik=0000320193

4 · insider_activity

Recent Form 4/3/5 filings with insider-cluster detection (multiple filers, same issuer).

GET /v1/insider_activity?days=7&ticker=TSLA

5 · search_filings (live)

GET /v1/search_filings?form=8-K&start=2026-06-01&end=2026-06-21&limit=50

6 · MCP (agent-callable)

Point any MCP client at https://filings.dropwatchhq.com/mcp (Streamable HTTP, JSON-RPC 2.0). Tools: whats_new_since, filing_digest, company_watch, insider_activity, search_filings.

curl -s https://filings.dropwatchhq.com/mcp -H "content-type: application/json" \
  -H "x-api-key: sck_live_xxx" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"filing_digest","arguments":{"ticker":"AAPL","days":7}}}'

7 · Saved filters, watchlists & webhooks paid tiers

POST /v1/filters     {"name":"my-coverage","filter":{"form":["8-K"],"minEventScore":5}}
POST /v1/watchlist   {"cik":"0000320193","webhook":"https://your.app/hook"}
# We POST {event,cik,company,filing} to your webhook when the daily snapshot
# finds a fresh filing for a watched company.

Honest scope & compliance

Live filing data is real and current (SEC EDGAR). The fresh-filing change-history (our moat) accrues from daily snapshots — thin the first days, sharpening over weeks. Endpoints flag this with a note while history is shallow. We respect SEC fair-access rate limits and declare a real User-Agent. This is a monitoring & research tool over public filings — not investment advice.