SEC filings API
List filings by company, form type, date, or 8-K item. Then read a filing's documents, its sections, and its amendments, all from one API.
What you get
- Filter any way
- Filter by company (
cik,ticker, orq), form type, filing date, feed day, 8-K item, or status. Sort by filing date, accession number, or acceptance time. - Amendments linked
- An amendment is linked to the filing it amends where possible, and
/versionslists the original and every amendment in order. - Parts of a filing
- Read a 10-K, 10-Q, or 20-F by section, such as Item 1A, Risk Factors. Read an 8-K by item. List the tables of a filing.
- Pages that scale
- A list returns 50 filings by default and up to 1000 with
limit. A cursor continues past that, with the same filters.
Example calls
Set SECBLAST_API_KEY to your key first.
Earnings 8-K filings (item 2.02) filed since November 1, 2026:
import os
import requests
r = requests.get(
"https://api.secblast.com/v3/filings",
params={"form": "8-K", "items": "2.02", "filed_from": "2026-11-01", "limit": "5"},
headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())The sections of one periodic report (10-K, 10-Q, or 20-F), with the status of each:
import os
import requests
r = requests.get(
"https://api.secblast.com/v3/filings/0000320193-26-000026/sections",
headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())In the API reference
- GET /v3/filingsList filings, newest first.
- GET /v3/filings/{accession}Get one filing.
- GET /v3/filings/{accession}/versionsList a filing's original and all its amendments.
- GET /v3/filings/{accession}/sectionsList the sections of a 10-K, 10-Q, or 20-F.
- GET /v3/events/8k/{item}List structured events for one 8-K item, newest first.
Questions
- How do I list every 8-K of a company?
- Call GET /v3/filings with
tickerandform=8-K. Additems, such as2.02, to keep only filings that carry those 8-K items. - Does a form filter include amendments?
- Yes.
form=10-Kalso matches 10-K/A. Theamendmentsparameter includes, excludes, or lists only amendments. - How do I read the next page?
- Pass
next_cursorfrom the response ascursor, with the same filters. See Pagination. - Which form types are covered?
- GET /v3/forms lists every form type with its filing count. The coverage page shows what is loaded.
- Can I be told about new filings instead of polling?
- Yes. See SEC filing alerts and webhooks.
Make your first request
Create a key, then use it in the examples above. The fees page lists what each plan includes.