# 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.

Plumbline: Know who you are dealing with. Runs instantly.

## 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 next

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

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.

## Operation: 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 allowance.

- `cik` (string): SEC CIK
- `ticker` (string): Ticker
- `concept` (string): XBRL concept name, default Revenues
- `taxonomy` (string): Default us-gaap

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

## Send a requirement

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.

POST https://plumbline.forevenza.com/company-financials/requests with JSON like:

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

Schema: https://plumbline.forevenza.com/company-financials/schema.json

## 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.

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

Privacy notice: https://plumbline.forevenza.com/privacy/