API guide: filings and structured facts
Find a company, inspect its filings and retrieve paginated XBRL facts with source and context information.
Find a company and filings
Search the imported company index by name, ticker or CIK, then fetch the company or its recent filings. CIKs are SEC identifiers. Ticker mappings are observed and a ticker can be ambiguous; use the CIK returned by search when necessary.
GET /v1/companies?query=apple
GET /v1/companies/AAPL
GET /v1/companies/AAPL/filingsSearch returns at most 50 companies; the filings route returns up to 100 recent imported filings. These routes require an API bearer token.
Search the structured filing index
The structured index is separate from the Company Facts company index and searches by company name or CIK. Use a numeric CIK of up to ten digits to retrieve facts.
GET /v1/structured/companies?query=apple
GET /v1/structured/companies/0000320193/facts?form=10-KFilter and page
Structured facts accept optional tag, form, as_of and cursor parameters. Supported form values are 10-K, 10-K/A, 10-Q, 10-Q/A, 20-F, 20-F/A, 6-K and 6-K/A. as_of is an inclusive filing-date cutoff.
Each page contains up to 100 facts. If next_cursor is non-null, pass it as cursor on the next request, keeping the other filters unchanged. Review source_revision, accession, source URL, tag, unit, period and dimensions; results contain all stored source and parser revisions.
Corporate-action example
GET /v1/companies/AAPL/corporate-actions?kind=split_ratio&from=2020-01-01This returns reported XBRL period facts, not a complete event calendar. from and to select reporting-period dates, not verified action dates. Use next_cursor for additional pages.