Retrieve company submissions history and XBRL financial facts via the SEC EDGAR data API

domain: sec.gov · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Resolve a company's CIK from its ticker using GET https://www.sec.gov/cgi-bin/browse-edgar?company=&CIK={ticker}&type=&dateb=&owner=include&count=10&search_text=&action=getcompany or the ticker-to-CIK mapping file at https://www.sec.gov/files/company_tickers.json
  2. Fetch the company's full submissions history (the last 1,000 filings inline, older filings paginated via additional JSON files) by calling GET https://data.sec.gov/submissions/CIK{10-digit-zero-padded-CIK}.json
  3. Parse the filings object in the submissions JSON; each filing entry includes accession number, form type, filing date, and primary document filename
  4. Retrieve all XBRL-tagged financial facts across all filings for a company with GET https://data.sec.gov/api/xbrl/companyfacts/CIK{10-digit-CIK}.json; the response is organized by taxonomy (us-gaap, dei, ifrs-full) and concept tag
  5. To fetch a single financial concept (e.g., us-gaap/Assets) over time, use GET https://data.sec.gov/api/xbrl/companyconcept/CIK{10-digit-CIK}/us-gaap/Assets.json
  6. No API key or authentication is required; set a descriptive User-Agent header (organization name and contact email) and stay within the SEC's rate limit guidance

Known gotchas

Related routes

Programmatically download and parse SEC EDGAR Inline XBRL (iXBRL) data from 10-K filings
sec.gov · 6 steps · unrated
Retrieve contracts and exhibits from SEC filings using the EDGAR full-text search API and the company Submissions API
sec.gov · 5 steps · unrated
Search SEC EDGAR filings using the full-text search API
efts.sec.gov · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans