{"uid":"cap_H5WxQ5vbfvgMP6Vjei2hU","slug":"sec-8-k-material-events-api-0df6156e","name":"SEC 8-K Material Events API","description":"SEC 8-K filings material events API: earnings, M&A, executive changes, auditor change, restatement, cybersecurity incident, bankruptcy, by stock ticker. Extractive/factual only — accession number, EDGAR filing URL, Item numbers with official Item titles verbatim, filed timestamp, response timestamp. No buy/sell signals, scores, sentiment, or rankings. highImportance is a fixed Item-number rule (1.02, 1.03, 1.05, 2.04, 2.05, 2.06, 3.01, 4.01, 4.02, 5.01), not a judgment. Informational only, not investment advice. Data: SEC EDGAR (public domain). Verify at source; provided as-is, no warranty.","url":"https://x402-8k-worker.stackstats.workers.dev/v1/8k-events/%7Bticker%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["ticker"],"properties":{"ticker":{"type":"string","pattern":"^[A-Za-z0-9.\\-]{1,10}$","description":"US stock ticker, case-insensitive (e.g. AAPL, TSLA, BRK-B)"}}},"queryParams":{"type":"object","properties":{"days":{"type":"integer","default":90,"maximum":365,"minimum":1,"description":"Look-back window in days (default 90, max 365)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ticker","cik","company","windowDays","count","events","respondedAt","source","disclaimer"],"properties":{"cik":{"type":"string","description":"10-digit zero-padded CIK"},"count":{"type":"integer","description":"Number of 8-K events in the window (not a ranking)"},"events":{"type":"array","items":{"type":"object","required":["form","accessionNumber","filedAt","items","highImportance","url"],"properties":{"url":{"type":"string","description":"Primary document URL on sec.gov (EDGAR)"},"form":{"type":"string","description":"8-K or 8-K/A"},"items":{"type":"array","items":{"type":"object","required":["code","label"],"properties":{"code":{"type":"string","description":"Item number, e.g. 2.02"},"label":{"type":"string","description":"Official Item title verbatim from SEC Item list"}}},"description":"Item numbers with official SEC Item titles verbatim"},"filedAt":{"type":"string","description":"SEC acceptance / filed timestamp (ISO 8601 or YYYY-MM-DD)"},"highSignal":{"type":"boolean","description":"Alias of highImportance (same fixed Item-number rule)"},"reportDate":{"type":"string","description":"Date of the reported event (YYYY-MM-DD)"},"highImportance":{"type":"boolean","description":"Fixed rule (not a judgment): true iff any Item code is in [1.02, 1.03, 1.05, 2.04, 2.05, 2.06, 3.01, 4.01, 4.02, 5.01]"},"accessionNumber":{"type":"string","description":"SEC accession number"}}}},"source":{"type":"string","const":"SEC EDGAR (public domain)"},"ticker":{"type":"string"},"company":{"type":"string"},"disclaimer":{"type":"string"},"windowDays":{"type":"integer"},"respondedAt":{"type":"string","description":"Response timestamp (ISO 8601, UTC)"},"highSignalCount":{"type":"integer","description":"Alias of highImportanceCount"},"highImportanceCount":{"type":"integer","description":"Count of events matching the fixed HIGH_IMPORTANCE_ITEMS Item-number rule"}}}}}}},"responseSchema":{"type":"json","example":{"cik":"0000320193","count":1,"events":[{"url":"https://www.sec.gov/Archives/edgar/data/320193/000032019326000071/aapl-20260731.htm","form":"8-K","items":[{"code":"2.02","label":"Results of Operations and Financial Condition"},{"code":"9.01","label":"Financial Statements and Exhibits"}],"filedAt":"2026-07-31T16:30:21.000Z","highSignal":false,"reportDate":"2026-07-31","highImportance":false,"accessionNumber":"0000320193-26-000071"}],"source":"SEC EDGAR (public domain)","ticker":"AAPL","company":"Apple Inc.","disclaimer":"Informational only, not investment advice. Data: SEC EDGAR (public domain). Verify at source; provided as-is, no warranty.","windowDays":90,"respondedAt":"2026-10-11T04:00:00.000Z","highSignalCount":0,"highImportanceCount":0}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_staDbGFaaUXLN-VMtgzKg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves SEC 8-K filing events for a given US stock ticker, including earnings, M&A, executive changes, cybersecurity incidents, and other material events from EDGAR","exampleAgentPrompt":"Pull all SEC 8-K material event filings for AAPL from the last 90 days and tell me if any are high-importance items like earnings results, executive changes, or cybersecurity incidents.","exampleUseCases":[{"title":"Earnings release monitoring for portfolio","prompt":"Check what 8-K filings Tesla has made in the last 30 days — I want to see if they've reported earnings results or any other material events from EDGAR."},{"title":"M&A and executive change alert","prompt":"Have there been any high-importance 8-K filings for Microsoft in the past 180 days? I'm specifically looking for M&A activity, executive departures, or auditor changes."},{"title":"Cybersecurity incident due diligence","prompt":"Look up all SEC 8-K filings for CrowdStrike over the last year and flag any that relate to cybersecurity incidents, restatements, or bankruptcy disclosures."}],"resultDescription":"Returns a JSON object with the company name, CIK, ticker, look-back window, and an array of 8-K filing events. Each event includes the accession number, direct EDGAR URL, form type (8-K or 8-K/A), filed timestamp, report date, list of SEC Item codes with official verbatim titles, and a highImportance boolean based on a fixed set of Item numbers (1.02, 1.03, 1.05, 2.04, 2.05, 2.06, 3.01, 4.01, 4.02, 5.01). Also returns total count, high-importance count, and a disclaimer.","failureModes":["Invalid ticker symbol returns an error or empty event array","Ticker not found in EDGAR returns zero results","Look-back window exceeding 365 days is rejected by schema validation","Network or upstream EDGAR availability issues may cause timeouts","Delisted or OTC tickers may have no EDGAR filings","Payment of $0.01 USDC required per call; unpaid requests are rejected via x402 protocol"],"whenToPreferThis":"Use this endpoint when you need structured, factual 8-K filing data from SEC EDGAR for a specific US-listed company by ticker, especially when you want machine-readable Item codes, official Item titles, accession numbers, and high-importance flags without any sentiment or scoring overlay. Prefer this over full EDGAR scraping when you need lightweight, cost-effective per-ticker lookups with clean JSON output.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:30:31.789Z","isFirstParty":false,"canonicalSlug":"sec-8-k-material-events-api-0df6156e"}