draconic21
Guide · SEC EDGAR XBRL

SEC EDGAR Company Facts: find the right value by ticker or CIK

The SEC's Company Facts API collects a company's reported XBRL concepts across filings. The hard part is choosing a value with the right unit, reporting period, and filing date.

Start with a ticker or CIK

The SEC's EDGAR API documentation shows the Company Facts endpoint as data.sec.gov/api/xbrl/companyfacts/CIK##########.json, with a ten-digit, zero-padded CIK. If you have a ticker, first map it to the correct CIK and company name; do not assume a ticker is permanent or unique across time. Our free CIK lookup can help with that step.

For a quick answer, enter a ticker or CIK in our free Company Facts lookup. It shows Assets, Revenues, and Net Income from live SEC data, with a limit of 20 lookups per IP per day. The SEC's source JSON is public and requires no API key; our page gives a smaller, readable view.

Try a free Company Facts lookup →

No signup. Check the original filing when a number matters.

Read the fact before comparing it

Company Facts groups values by taxonomy and concept, then by unit. A tag such as Assets is an instant at a balance-sheet date; a revenue value covers a duration. A later filing can report a fact for an earlier period, so “most recently filed” and “latest period end” are different filters.

  1. Concept: confirm the accounting tag answers your question. Companies can use different reported concepts; a missing tag is not a zero.
  2. Unit: compare USD with USD, shares with shares, or USD per share with the same unit. The SEC separates facts by unit in its API.
  3. Period: retain the start and end dates, fiscal year, fiscal period, and form. A quarterly duration is not the same as a year-to-date or annual duration.
  4. Filed date: keep the filing date and accession number so a later reviewer can trace the number back to the disclosure and spot amended filings.

The SEC documents that its XBRL APIs aggregate standard taxonomy facts applying to the entire filing entity. Company-specific extensions may therefore require reading the underlying filing. Use the SEC API reference for the source format and update schedule.

Choose a repeatable workflow

Local CSV: the live SEC EDGAR Starter Kit ($19) includes a Python CLI and notebook for CIK lookup, filings, 8-K Items, and XBRL facts-to-CSV. It is a broader research starter, not a replacement for reviewing source filings.

API calls: our Company Facts API accepts a ticker or CIK and up to 25 requested concepts per call. The x402 route is $0.02 per call in Base USDC. If you use card billing, the same endpoint is available in the RapidAPI listing, which has a free BASIC tier and paid monthly plans. Check the listing for current limits and prices.

For large SEC-wide downloads, the SEC also publishes a nightly Company Facts bulk ZIP. Its developer guidance covers automated access and declared user agents.

Research data, not investment advice. Verify material numbers in the original SEC filing and use consistent concepts, units, and periods before comparing companies.