SEC EDGAR Filings & Financials — ask by ticker

Company filings and reported financial figures, from the SEC's own public API.

Input:   { "companies": ["AAPL", "NVDA"], "forms": ["10-K", "10-Q"] }
Output:  one row per filing — form, date, period, and a direct link to the document

Ask by ticker, not CIK

EDGAR identifies every company by a ten-digit CIK, and nobody remembers CIKs. This resolves tickers against the SEC's own ticker list — 10,000+ companies — so AAPL just works. CIK numbers are accepted too.

Two modes

Filings — what a company has submitted, newest first.

{ "companies": ["AAPL", "MSFT"], "mode": "filings", "forms": ["10-K", "10-Q", "8-K"], "since": "2024-01-01" }

Every row carries documentUrl, a direct link to the filing itself — so you can hand it straight to a text extractor rather than working out where the document lives.

Financials — reported figures across every period a company has filed, from XBRL.

{ "companies": ["NVDA"], "mode": "financials", "concepts": ["revenue", "netIncome", "eps"] }

Shorthands cover what people usually want:

revenue · netIncome · assets · liabilities · equity · cash · eps · operatingIncome · researchAndDevelopment · sharesOutstanding

A raw XBRL tag works too, if you know the one you want.

Input

Field	Type	Default	What it does
companies	array of strings	["AAPL"]	Tickers or CIK numbers
mode	string	filings	filings or financials
forms	array of strings	["10-K","10-Q","8-K"]	Filings mode. Empty means every form
concepts	array of strings	all shorthands	Financials mode. Shorthand names or XBRL tags
since	string	—	YYYY-MM-DD. Filings mode
limit	integer	40	Max rows per company. 0 for no limit

Output

Filings rows carry the company (name, tickers, industry, state of incorporation), the filing (form, filedAt, reportDate, accession number, whether it has XBRL) and two links: the document itself and its index page.

Financials rows carry the figure (concept, tag, label), its value and unit, and the period it covers (fiscalYear, fiscalPeriod, periodStart, periodEnd, filedAt). Newest first.

A SUMMARY record lists which CIK each company resolved to and how many rows it produced.

Pricing

	Price
Starting a run	$0.00001 — one US cent per 1,000 runs
Each row returned	$0.0005 — 50 US cents per 1,000 rows

A company that never reported a figure produces no rows for it, and errors go to the log and SUMMARY rather than the dataset — so what a company did not file costs nothing.

Works well with

Pair it with a document text extractor: this finds which filings exist and where each document is, that one reads them. documentUrl is on every filings row for exactly this.

Typical uses

• Fundamental screening. Pull one figure across many companies and compare periods.
• Filing alerts. Run on a schedule with since and catch new submissions.
• Research pipelines. Get the document URLs, extract the text, feed a model.
• Ownership and insider activity. Form 4 filings are just another form type.

Notes on data and compliance

• The SEC publishes these endpoints and asks that clients identify themselves with a contact. This Actor does, in its user agent.
• The SEC asks for no more than 10 requests a second; this stays far below that.
• Filings are public regulatory disclosures. Reading them is the purpose of the system.

Limitations — stated up front

• US registrants only. EDGAR covers companies that file with the SEC.
• Only the filing metadata and links are returned, not the document text — use a text extractor for that, which keeps this fast and cheap when you only need the index.
• XBRL figures exist only from around 2009 and only for companies that tag them.
• A figure a company never reported returns nothing rather than a zero. That distinction matters, so it is preserved.
• Revenues is one of several revenue tags in US GAAP; a company using a different one will return nothing for the revenue shorthand. Pass the exact tag when this matters.

Not affiliated

This is an independent tool. It is not affiliated with or endorsed by the U.S. Securities and Exchange Commission. Data comes from the SEC's publicly documented EDGAR APIs.