Microproduct data guideintermediate

SEC EDGAR Submissions and Company Facts

Real-time public-company filing histories and structured financial facts for building disclosure alerts, research tools, and company monitors.

Start the guide Open official source

At a glance

Difficulty
Intermediate — some data preparation helps
Size
Large · 0.001–10 GB
Formats
JSON, ZIP, XBRL
Access
API or Download
API key
Not required
Provider
U.S. Securities and Exchange Commission
Updates
Continuous
Data terms
SEC public-information and website-dissemination policy

From source to product signal

Test a product idea in four steps

EDGAR provides company submission histories and standardized XBRL facts without an API key. Start with one company's recent filings and identify it by its zero-padded CIK. Filing forms, amendments, reporting periods, units, and company-specific taxonomy extensions must be interpreted before records are compared.

1

Check the setup

  • Python 3.10 or newer
  • A notebook environment such as Jupyter or Google Colab
  • A descriptive application name and contact address for the User-Agent header
2

Access the data

  1. 1.Read the EDGAR API documentation and fair-access guidance.
  2. 2.Find one company's CIK and pad it to ten digits.
  3. 3.Request its submissions JSON while staying below the published request limit.
Open official source
3

Run the Python example

Install the packages, then run the notebook cell.

python -m pip install pandas requests

import pandas as pd
import requests

headers = {
    "User-Agent": "TrilemmaDataGuide/1.0 contact@trilemma.foundation"
}
response = requests.get(
    "https://data.sec.gov/submissions/CIK0000320193.json",
    headers=headers,
    timeout=30,
)
response.raise_for_status()
payload = response.json()
filings = pd.DataFrame(payload["filings"]["recent"])
print(filings[["filingDate", "form", "accessionNumber", "primaryDocument"]].head())
4

Test a useful signal

Build a material-filing watchlist

Determine whether recent 8-K, 10-Q, and 10-K filings can power a timely company-disclosure alert.

  1. 01Filter the recent filing history to 8-K, 10-Q, 10-K, and amended versions of those forms.
  2. 02Sort by filing date and construct the official archive URL from each accession number and primary document.
  3. 03Inspect the latest filing and explain why its form type alone does not establish materiality or investment significance.

Dataset details

U.S. Securities and Exchange Commission is a government source. Last verified 2026-08-11. Temporal coverage: 1994-present; structured XBRL primarily 2009-present.

Domains

Corporate FilingsFinanceRegulation

Data types

Event DataFinancial StatementsTime Series

Tasks

Filing MonitoringFinancial AnalysisCompany Research

Geography

United States

Formats

JSONZIPXBRL

Provider

U.S. Securities and Exchange Commission

Data terms

SEC public-information and website-dissemination policy