SEC Filing Events API

Read Form 8-K leadership and auditor changes, Form 4 insider transactions, and their EDGAR sources in JSON.

First request

The demo needs no authentication. Add your API key as a Bearer token when you query the subscriber API.

curl 'https://filingrelay.com/v1/demo?kind=auditor_change'
curl 'https://filingrelay.com/v1/events?ticker=AAPL&form=4&kind=insider_transaction&limit=10' \
  -H "Authorization: Bearer $FILINGRELAY_KEY"

Read the feed

curl 'https://filingrelay.com/v1/events?cik=0002091349&kind=leadership_change&action=appointed' \
  -H "Authorization: Bearer $FILINGRELAY_KEY"

accepted_at comes from EDGAR. published_at records first observation by FilingRelay when known. event_date is the underlying event or transaction date when available. Unresolved filings include a status and a link to the SEC.

Form 4 transaction codes and examples · SEC filing alerts

Watchlists, webhooks and exports

POST /v1/watchlists
{"name":"Portfolio","companies":["AAPL","MSFT"],"kinds":["insider_transaction"]}

POST /v1/webhooks
{"url":"https://your-service.example/filings","watchlist":1}

POST /v1/exports
{"format":"csv","filters":{"ticker":"AAPL","from":"2026-01-01"}}

Validate the FilingRelay-Signature header against the HMAC-SHA256 of t + "." + raw_body. Compare signatures in constant time. Reject stale timestamps and deduplicate by FilingRelay-Delivery. Delivery is at least once. Use the dashboard or the deliveries API to replay a failed delivery.

Python example
import json, os, urllib.request

req = urllib.request.Request(
    "https://filingrelay.com/v1/events?kind=auditor_change",
    headers={"Authorization": "Bearer " + os.environ["FILINGRELAY_KEY"]},
)
with urllib.request.urlopen(req) as response:
    print(json.load(response)["data"])
JavaScript signature example
import { createHmac, timingSafeEqual } from "node:crypto";

export function verify(headers, rawBody, secret) {
  const fields = Object.fromEntries(
    headers["filingrelay-signature"].split(",").map(x => x.split("="))
  );
  if (!/^\d+$/.test(fields.t) || !/^[a-f0-9]{64}$/.test(fields.v1)) return false;
  if (Math.abs(Date.now() / 1000 - Number(fields.t)) > 300) return false;
  const computed = createHmac("sha256", secret)
    .update(fields.t + ".").update(rawBody).digest();
  return timingSafeEqual(computed, Buffer.from(fields.v1, "hex"));
}