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

Status: working operation.

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

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

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

## Make a request

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://services.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://services.forevenza.com/company-financials/schema.json