Material Events

Monitor 8-K material events like earnings, leadership changes, and acquisitions.

Prerequisites

• An edgar.tools API key with Professional tier access
• A company ticker or CIK number

1. Get material events

The material events endpoint returns 8-K filings for a company, including item codes that describe the type of event disclosed.

curl -H "Authorization: Bearer etk_your_key_here" \
  "https://api.edgar.tools/v1/companies/AAPL/material-events"

import requests

response = requests.get(
    "https://api.edgar.tools/v1/companies/AAPL/material-events",
    headers={"Authorization": "Bearer etk_your_key_here"},
)
events = response.json()

2. Understand 8-K item codes

Each 8-K filing references one or more item codes that categorize the event. Common codes:

• Item 1.01 — Entry into a Material Definitive Agreement
• Item 2.02 — Results of Operations and Financial Condition (earnings)
• Item 5.02 — Departure or Election of Directors or Officers
• Item 8.01 — Other Events

3. Filter by recency

Use days_back to limit results to a recent window, and limit to cap the number of events returned.

curl -H "Authorization: Bearer etk_your_key_here" \
  "https://api.edgar.tools/v1/companies/AAPL/material-events?days_back=90&limit=10"

response = requests.get(
    "https://api.edgar.tools/v1/companies/AAPL/material-events",
    params={"days_back": 90, "limit": 10},
    headers={"Authorization": "Bearer etk_your_key_here"},
)
recent_events = response.json()

4. Combine with AI summaries

For quick context on a company, pair material events with the AI summary endpoint. The summary distills business profile, products, and risk factors from the latest 10-K into a concise overview.

curl -H "Authorization: Bearer etk_your_key_here" \
  "https://api.edgar.tools/v1/companies/AAPL/ai-summary"

response = requests.get(
    "https://api.edgar.tools/v1/companies/AAPL/ai-summary",
    headers={"Authorization": "Bearer etk_your_key_here"},
)
summary = response.json()

To summarize

• Events endpoint returns 8-K filings with item codes
• Use days_back to narrow the time window for recent events (max 730)
• Combine with ai-summary for quick company context
• Requires Professional tier access

Related guides

• Companies — search for companies and retrieve profiles
• Filings — browse real-time and historical SEC filings
• Insider Trades — track insider buying and selling activity