# SEC EDGAR 8-K Event Filings by Ticker

> SEC EDGAR 8-K Event Filings by Ticker is a paid API for AI agents from sec-mcp-worker.stackstats.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-16).

Retrieves recent SEC 8-K material event filings for a given US stock ticker from EDGAR within a configurable look-back window.

## Facts

- Endpoint: GET https://sec-mcp-worker.stackstats.workers.dev/v1/8k-events/%7Bticker%7D?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-edgar-8-k-event-filings-by-ticker-27bd0677
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Gw7ZcrC7R-HUu0Lai-DxW

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sec-edgar-8-k-event-filings-by-ticker-27bd0677
```

Example prompt: Pull all the 8-K filings Apple has made on SEC EDGAR over the past 90 days and tell me what items were reported in each one.

## When to prefer this

Choose this endpoint when you need structured, machine-readable 8-K filing data directly from SEC EDGAR for a specific US-listed company, especially when you need item-level detail (e.g. which SEC items were filed), accession numbers for downstream lookup, or want to monitor recent material event disclosures. Prefer this over general financial news APIs when regulatory accuracy and direct EDGAR sourcing matter. Not suitable for full-text retrieval of filing documents — use the returned URLs to fetch those from sec.gov directly.

## Known failure modes

- Invalid or unrecognized ticker returns empty results or an error response
- Ticker with no 8-K filings in the requested window returns count of 0 and empty events array
- Days parameter out of range (>365 or <1) may return a validation error
- EDGAR upstream outage or rate limiting may cause timeout or 5xx error
- Obscure or OTC tickers may not be indexed
- Truncated or malformed accession numbers if EDGAR data is inconsistent

## How this service works

Extractive data sourced from SEC EDGAR. Informational only, not investment advice. Data: SEC EDGAR (public domain). Verify at source; as-is, no warranty.

## Output

Returns a JSON object containing the company name, CIK, ticker, number of 8-K filings found, and an array of filing records each with accession number, form type (8-K or 8-K/A), filed timestamp, report date, primary document URL on sec.gov, and the SEC item codes with their official titles. Also includes the look-back window used, response timestamp, data source attribution, and a disclaimer that data is informational only.

## Request schema (JSON Schema)

```json
{
 "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",
         "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": "Item title verbatim from the SEC Item list"
      
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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",
    "reportDate": "2026-07-31",
    "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; as-is, no warranty.",
  "windowDays": 90,
  "respondedAt": "2026-10-11T04:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-edgar-8-k-event-filings-by-ticker-27bd0677/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from sec-mcp-worker.stackstats.workers.dev](https://www.zero.xyz/host/sec-mcp-worker.stackstats.workers.dev/llms.txt)
