Plumbline / Reported financials

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.

The answer appears here, with the record it came from.

Something this does not cover

Describe the lookup you need.

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.

Who uses it

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

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.

Who runs it, and what it costs

Plumbline. Operated by Tempered Technologies LLC, 8 The Green STE B, Dover, DE 19901. Privacy questions and deletion requests: privacy@forevenza.com. Privacy notice.

Free to use within a daily allowance; sending a requirement is free.

Scope

Companies that file XBRL financial statements with the SEC.

Private companies and non-SEC filers are not covered.
Only US-GAAP or IFRS concepts the company actually tagged are available.
No ratios or estimates are computed.

Sources

SEC EDGAR publishes XBRL company facts and concepts through public JSON APIs. www.sec.gov

For developers and agents

Send the same requirement as JSON to POST /company-financials/requests (schema: /company-financials/schema.json), or call the submit_request tool on the MCP endpoint at https://plumbline.forevenza.com/mcp. This page as Markdown: index.md.

{
  "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"
  }
}

`GET /company-financials/op/facts`

Every reported value of one XBRL concept for one SEC filer, with period, form and accession number. Free, within a daily allowance.

Parameter	Type	Meaning
`cik`	string	SEC CIK
`ticker`	string	Ticker
`concept`	string	XBRL concept name, default Revenues
`taxonomy`	string	Default 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.