Docs / API reference
GET /v1/events/{ticker}
8-K material events as a typed stream. Each event carries its item codes with human labels
(2.02 earnings, 5.02 exec change, 1.05 cyber incident, 2.01 acquisition…), a notable flag for
the market-moving ones, and a link to the filing.
Parameters
| Param | In | Values |
|---|---|---|
ticker | path | US stock ticker, e.g. AAPL |
limit | query | 1–100 (default 20) |
notable | query | true to keep only earnings, M&A, exec changes, breaches, etc. |
item | query | Filter to a specific 8-K item code, or comma-separated codes, e.g. 4.02 (restatement) or 5.02,2.02 |
Request
curl "https://api.edgrapi.com/v1/events/AAPL?notable=true" -H "X-API-Key: edgr_..."
# every restatement a company has filed
curl "https://api.edgrapi.com/v1/events/AAPL?item=4.02" -H "X-API-Key: edgr_..."Response
{
"ticker": "AAPL", "cik": "0000320193", "company": "Apple Inc.", "count": 1,
"events": [
{ "filed": "2025-08-01", "accession": "0000320193-25-000101",
"url": "https://www.sec.gov/Archives/edgar/data/320193/.../aapl-8k.htm",
"notable": true,
"items": [ { "code": "2.02", "label": "Results of Operations and Financial Condition" },
{ "code": "9.01", "label": "Financial Statements and Exhibits" } ] }
],
"source": "SEC EDGAR 8-K"
}Market-wide red-flag feeds
Two convenience routes scan recent 8-Ks across all filers for the highest-signal item codes:
| Route | Item | Signal |
|---|---|---|
GET /v1/events/restatements | 4.02 | Non-reliance on previously issued financials — past numbers can't be trusted |
GET /v1/events/auditor-changes | 4.01 | Change of the certifying accountant — an auditor switch |
curl "https://api.edgrapi.com/v1/events/restatements?days=45" -H "X-API-Key: edgr_..."