Service
Public SEC EDGAR provider: company lookup by name/ticker, filing history, and XBRL financial facts via SEC's official no-auth JSON APIs (data.sec.gov, www.sec.gov). Requires a descriptive User-Agent per SEC's fair-access policy; no API key needed.
99.96%30-day uptimeAvg response397ms
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/sec-edgar-filings/company-facts | Retrieves one company's reported XBRL facts for a single required us-gaap concept (e.g. 'Assets') and returns a caller-selected fact page (default 20, maximum 100). Use when you need one company's reported history for one line item; obtain central_index_key from sec-edgar-filings:search-companies first. Do NOT use to compare many companies for one period — use sec-edgar-filings:xbrl-frame instead. concept is required so that a single call never returns a company's entire fact catalog; an unknown concept or CIK returns NOT_FOUND. Returns central_index_key, facts (concept, unit, value, fiscal_year, fiscal_period, period_ended_on, form_type), total_count, page, limit, and has_more. | |
| POST | /v1/sec-edgar-filings/company-filings | Lists a company's SEC filings from data.sec.gov/submissions/CIK{10-digit-cik}.json, sorted by filed_on descending, optionally filtered to one exact form_type ('10-K' and '10-K/A' are distinct codes — no partial matching). Use when you need a company's filing history or a direct link to a filing document; obtain central_index_key from sec-edgar-filings:search-companies first. Do NOT use for reported financial values — use sec-edgar-filings:company-facts instead. Covers only SEC's 'recent' window (the most recent up to 1000 filings per company — in practice the full multi-year history of any active large filer); total_count counts filings in that window, not the company's complete history. primary_document_url is built from the accession number and primary document filename and is null on the rare pre-2001 filing where SEC recorded no primary document. Unknown CIK returns NOT_FOUND. Returns central_index_key, filings (accession_number, form_type, filed_on, period_of_report, primary_document_url), total_count, page, and has_more. | |
| POST | /v1/sec-edgar-filings/search-companies | Searches SEC's registered company and ticker list by company name or ticker and returns a ranked, deterministic page of matches. Use when you need a company's Central Index Key (CIK), ticker, or listing exchange — for example to resolve a company name to the central_index_key that company-filings and company-facts require. Do NOT use for a company's filings or financial data — use sec-edgar-filings:company-filings or sec-edgar-filings:company-facts instead. Page size defaults to 20 and is capped at 50; the same query and page always return the same rows. Returns companies (central_index_key, company_name, ticker, exchange), total_count, page, and has_more. |
Issue a sandbox key and make your first reservation.
APIFuse holds the partner credentials. You hold one managed key.
Receive events such as reservation confirmations and delivery updates.
Service outages and gateway errors normalise into one error model.
| POST | /v1/sec-edgar-filings/xbrl-frame | Retrieves one official SEC XBRL frame — one fact per reporting entity for a single concept, unit, and calendar period (e.g. us-gaap / Revenues / USD / CY2024) — and returns a deterministic caller-selected entity page (default 20, maximum 100). Use when you need to compare one concept across companies for a single period. Do NOT use for one company's history of a concept — use sec-edgar-filings:company-facts instead. Entity names are not included; each fact carries the entity's central_index_key. An unknown taxonomy, concept, unit, or period combination returns NOT_FOUND. Returns taxonomy, concept, unit, period, label, description, total_count, facts (central_index_key, location, period_ended_on, value, accession_number), page, limit, and has_more. |
