GET /v1/edgar/events

$0.02delayed_15mtier: datacache 600sEngine D — Gov Data / EDGAR

Material corporate events from SEC 8-K filings, deterministically classified by Item number (5.02 → leadership_change, 2.02 → results, 1.01 → material_agreement, …) with a two-sentence extractive summary and the filing URL. Filter by ticker, event type, or date.

Parameters

Example

curl "https://x402-factory.com/v1/edgar/events"

Most recent classified 8-K events across covered companies.

Example response

{
  "data": {
    "events": [
      {
        "ticker": "AAPL",
        "company": "Apple Inc.",
        "type": "results",
        "item_numbers": [
          "2.02",
          "9.01"
        ],
        "headline": "Results of Operations and Financial Condition",
        "summary": "On April 30, 2026, Apple Inc. (“Apple”) issued a press release regarding Apple’s financial results for its second fiscal quarter ended March 28, 2026. A copy of Apple’s press release is attached hereto as Exhibit 99.1.",
        "filed_at": "2026-04-30",
        "url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019326000011/aapl-20260430.htm"
      },
      {
        "ticker": "AAPL",
        "company": "Apple Inc.",
        "type": "leadership_change",
        "item_numbers": [
          "5.02"
        ],
        "headline": "Departure of Directors or Certain Officers; Election of Directors; Appointment of Certain Officers; Compensatory Arrangements of Certain Officers",
        "summary": "On April 20, 2026, Apple Inc. (“Apple”) announced that Tim Cook will transition from his role as Chief Executive Officer to Executive Chair of Apple’s Board of Directors (the “Board”), effective September 1, 2026 (the “Transition Date”). On April 17, 2026, the Board appointed John Ternus, Apple’s Senior Vice President of Hardware Engineering, as Chief Executive Officer and a member of the Board, in each case effec…",
        "filed_at": "2026-04-20",
        "url": "https://www.sec.gov/Archives/edgar/data/0000320193/000114036126015711/ef20071035_8k.htm"
      },
      {
        "ticker": "AAPL",
        "company": "Apple Inc.",
        "type": "shareholder_vote",
        "item_numbers": [
          "5.07",
          "9.01"
        ],
        "headline": "Submission of Matters to a Vote of Security Holders",
        "summary": "Apple Inc. filed an 8-K reporting: Submission of Matters to a Vote of Security Holders.",
        "filed_at": "2026-02-24",
        "url": "https://www.sec.gov/Archives/edgar/data/0000320193/000114036126006577/ef20060722_8k.htm"
      },
      {
        "ticker": "AAPL",
        "company": "Apple Inc.",
        "type": "results",
        "item_numbers": [
          "2.02",
          "9.01"
        ],
        "headline": "Results of Operations and Financial Condition",
        "summary": "Apple Inc. filed an 8-K reporting: Results of Operations and Financial Condition.",
        "filed_at": "2026-01-29",
        "url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019326000005/aapl-20260129.htm"
      },
      {
        "ticker": "AAPL",
        "company": "Apple Inc.",
        "type": "leadership_change",
        "item_numbers": [
          "5.02"
        ],
        "headline": "Departure/Election of Directors or Principal Officers",
        "summary": "Apple Inc. filed an 8-K reporting: Departure/Election of Directors or Principal Officers.",
        "filed_at": "2026-01-02",
        "url": "https://www.sec.gov/Archives/edgar/data/0000320193/000114036126000199/ef20060722_8k.htm"
      },
      {
        "ticker": "AAPL",
        "company": "Apple Inc.",
        "type": "leadership_change",
        "item_numbers": [
          "5.02"
        ],
        "headline": "Departure/Election of Directors or Principal Officers",
        "summary": "Apple Inc. filed an 8-K reporting: Departure/Election of Directors or Principal Officers.",
        "filed_at": "2025-12-05",
        "url": "https://www.sec.gov/Archives/edgar/data/0000320193/000114036125044561/ef20060722_8k.htm"
      },
      {
        "ticker": "AAPL",
        "company": "Apple Inc.",
        "type": "results",
        "item_numbers": [
          "2.02",
          "9.01"
        ],
        "headline": "Results of Operations and Financial Condition",
        "summary": "Apple Inc. filed an 8-K reporting: Results of Operations and Financial Condition.",
        "filed_at": "2025-10-30",
        "url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019325000077/aapl-20251030.htm"
      }
    ]
  },
  "meta": {
    "endpoint": "/v1/edgar/events",
    "version": "1.0.0",
    "generated_at": "2026-08-18T22:54:16.751Z",
    "freshness": "delayed_15m",
    "sources": [
      "edgar"
    ],
    "request_id": "req_00000000",
    "docs": "https://x402-factory.com/docs/gov.edgar-events",
    "data_mode": "live"
  }
}

Response schema (data payload)

{
  "type": "object",
  "properties": {
    "events": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "ticker": {
            "type": "string"
          },
          "company": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "item_numbers": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "headline": {
            "type": "string"
          },
          "summary": {
            "type": "string",
            "description": "≤2 sentences, extractive (no LLM)"
          },
          "filed_at": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "ticker",
          "company",
          "type",
          "item_numbers",
          "headline",
          "summary",
          "filed_at",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "events"
  ],
  "additionalProperties": false
}

The platform wraps every payload in an envelope: { "data": …, "meta": { endpoint, version, generated_at, freshness, sources, request_id, docs, data_mode } }.

Payment (x402)

Unpaid requests receive 402 with payment requirements (accepts). Pay $0.02 in USDC on Base per call via an X-PAYMENT header — see docs.x402.org. With PAYMENT_MODE=disabled (local dev) the endpoint is open.

Errors