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
GET /v1/companies?q=searches name, ticker, or CIK.- Combine
cikortickerwithkind,action, orform. Usepersonwith a verified reporting owner CIK such as Ajim Tamboli. See all query parameters. Retain filters when passing backnext_cursor. GET /v1/filings/{accession}returns filing status and extracted events.GET /v1/changes?after=returns changes in sequence order. Storenext_afterafter successful processing.
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"));
}