The 8-K API, as JSON.

• 1.01

  Entry into a Material Definitive Agreement

  The company signed a contract that matters — a credit facility, a major supply deal, a merger agreement, a licensing arrangement. The defining event for tracking deal flow.

• 2.01

  Completion of Acquisition or Disposition of Assets

  An acquisition or divestiture closed. Pairs with Item 1.01 (the signing) to mark the start and end of a transaction.

• 5.02

  Departure / Election of Directors or Officers

  A C-suite or board change — a CEO resigns, a CFO is appointed, a director departs. One of the most-watched item codes for governance and event-driven monitoring.

• 7.01

  Regulation FD Disclosure

  Information the company chose to disclose publicly under Reg FD — often a press release, investor-deck reference, or pre-announcement. Frequently carries an exhibit under Item 9.01.

• 9.01

  Financial Statements and Exhibits

  The attachments index. Lists the exhibits filed with the 8-K — press releases (EX-99.1), agreements, and supporting documents. Rarely appears alone; tags along with the substantive item.

1. 1

   Subscribe on RapidAPI

   Subscribe to the free Basic tier (50 requests/day, no card) and copy your X-RapidAPI-Key from the dashboard.

2. 2

   Call the 8-K events endpoint

   Request the endpoint for each ticker you follow. Two headers, one path parameter.

3. 3

   Filter by item code

   Keep the events whose codes intersect your watchlist — 5.02 for leadership changes, 1.01 + 2.01 for deals, 7.01 for Reg FD disclosures.

4. 4

   Trace back to the source filing

   Open meta.source_filing_url on any record to confirm it against the original 8-K on sec.gov before you act on it.

# 1. Pull the latest 8-K events for one issuer
curl --request GET \
  --url 'https://filingrail.p.rapidapi.com/v1/companies/AAPL/8k-events?limit=20' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --header 'X-RapidAPI-Host: filingrail.p.rapidapi.com'

import os
import requests

HOST = "filingrail.p.rapidapi.com"
HEADERS = {
    "X-RapidAPI-Key": os.environ["RAPIDAPI_KEY"],
    "X-RapidAPI-Host": HOST,
}

# Watch a watchlist for new departure / acquisition events
WATCH_CODES = {"5.02", "2.01", "1.01"}

def new_material_events(ticker):
    resp = requests.get(
        f"https://{HOST}/v1/companies/{ticker}/8k-events",
        params={"limit": 20},
        headers=HEADERS,
        timeout=10,
    )
    resp.raise_for_status()
    for event in resp.json()["data"]:
        codes = {item["code"] for item in event["items"]}
        if codes & WATCH_CODES:
            yield {
                "ticker": ticker,
                "event_date": event["event_date"],
                "codes": sorted(codes & WATCH_CODES),
                # Every record traces back to the SEC filing it came from:
                "source": event,  # paired with meta.source_filing_url
            }

for hit in new_material_events("AAPL"):
    print(hit["event_date"], hit["codes"])

To catch filings the moment they reach EDGAR, pair this with /v1/filings/recent?type=8-K and resolve each hit through this endpoint.