Requirements Desk

Working operationfinancialssecxbrlpublic companies

Reported financial figures for US public companies

Return a public company's reported figures (revenue, net income, assets and other XBRL concepts) by fiscal period, straight from its SEC filings.

What it is for

Sizing a customer, checking a supplier's scale or comparing competitors needs the figures a company actually reported, by period, with the filing they came from. This returns SEC XBRL facts for one company and one concept, each tied to its accession number, instead of a figure copied from a summary site.

Sales and credit teams sizing accounts, analysts comparing public companies, and agents answering questions about a listed company's scale.

What happens to a request

The call reads SEC EDGAR's XBRL companyconcept API for the CIK or ticker and concept you give, and returns every reported value with its period, form, fiscal year and accession number. Figures are as filed; restatements appear as separate rows.

What you get

A JSON answer with each reported value of the concept: start and end dates, value, unit, form, fiscal year and period, filing date and accession number.

Scope and limits

Companies that file XBRL financial statements with the SEC.

What you can specify

Operations

GET /company-financials/op/facts

Every reported value of one XBRL concept for one SEC filer, with period, form and accession number.

Price: free, within a daily budget.

ParameterTypeMeaning
cikstringSEC CIK
tickerstringTicker
conceptstringXBRL concept name, default Revenues
taxonomystringDefault us-gaap

Example answer:

{
  "cik": "0000320193",
  "entity": "Apple Inc.",
  "concept": "RevenueFromContractWithCustomerExcludingAssessedTax",
  "unit": "USD",
  "values": [
    {
      "start": "2025-09-28",
      "end": "2026-09-26",
      "value": 478834000000,
      "form": "10-K",
      "fy": 2026,
      "fp": "FY",
      "filed": "2026-11-03",
      "accession": "0000320193-26-000026"
    }
  ],
  "source": "https://data.sec.gov/api/xbrl/companyconcept/CIK0000320193/us-gaap/RevenueFromContractWithCustomerExcludingAssessedTax.json"
}

Sources: SEC EDGAR XBRL companyconcept API (US government work, public). Limits: one company and one concept per call; the 40 most recent values.

Next step

Call GET /company-financials/op/facts?ticker=AAPL&concept=RevenueFromContractWithCustomerExcludingAssessedTax (free, within a daily budget). Or describe the financial data you need that this does not cover.

Or send JSON to POST /company-financials/requests (schema: /company-financials/schema.json). Example:

{
  "action": "retrieve",
  "need": "Apple's reported annual revenue for the last three fiscal years with the filing each came from.",
  "specifications": {
    "company": "AAPL",
    "metrics": [
      "revenue"
    ],
    "periods": "FY2024-FY2026"
  }
}

Sources for statements on this page