GET /v1/edgar/events/leadership-change

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

Latest 8-K filings classified as executive and board leadership change (Item 5.02) across covered companies, parsed into structured JSON with extractive summaries and filing links. Same shape as /v1/edgar/events, pre-filtered to Item 5.02 events.

Parameters

NameInTypeRequiredNotes
tickerquerystringno
sincequerystringnoOnly events filed on/after this date
limitqueryintegerno (default: 20)

Example

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

Most recent classified 8-K events across covered companies.

Example response

{
  "data": {
    "events": [
      {
        "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": "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"
      }
    ]
  },
  "meta": {
    "endpoint": "/v1/edgar/events/leadership-change",
    "version": "1.0.0",
    "generated_at": "2026-08-18T22:54:16.752Z",
    "freshness": "delayed_15m",
    "sources": [
      "edgar"
    ],
    "request_id": "req_00000000",
    "docs": "https://x402-factory.com/docs/gov.edgar-events.leadership-change",
    "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

StatusCodeMeaning
400INVALID_PARAMSInput failed validation; message lists the offending fields.
404NOT_FOUNDNo matching resource; suggestion may point to a sibling endpoint.
410RESOLVEDMarket/event settled; body includes a resolution summary.
503STALE_DATAUpstream feed down; stale data is never silently served beyond 2× cache TTL.
500INTERNALOur bug. The request_id helps us find it.