# US Company Financials & Fundamentals API
> Live fundamental financials for US public companies straight from the SEC's official XBRL data — no key, nothing stored. The "what does the balance sheet and income statement say" view of a company: the actual reported revenue, earnings, assets and equity pulled from its SEC filings, distinct from the quote, analyst, insider and SEC-filings (EDGAR) APIs in the catalogue. The financials endpoint returns the latest annual key figures: revenue, gross profit, operating income, net income, total assets, total liabilities, shareholders' equity, cash, diluted EPS and the computed net margin. The concept endpoint returns the multi-year time series for a single metric — revenue history, net-income history and more — so you can chart how a company has grown. The company endpoint resolves a ticker to its SEC company (CIK and legal name). Build stock-screeners, valuation models, fundamentals dashboards and research tools on top of authoritative SEC data. Look up any US public company by its ticker; figures are the latest annual (10-K) values reported to the SEC in USD.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/financials-api/..."
```

## Pricing
- **Free** (Free) — 12,800 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 195,000 calls/Mo, 10 req/s
- **Pro** ($25/Mo) — 805,000 calls/Mo, 28 req/s
- **Scale** ($57/Mo) — 2,900,000 calls/Mo, 60 req/s

## Endpoints

### Financials

#### `GET /v1/financials` — Latest annual key financials for a company

**Parameters:**
- `ticker` (query, required, string) — Stock ticker Example: `AAPL`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/financials-api/v1/financials?ticker=AAPL"
```

**Response:**
```json
{
    "data": {
        "cik": 320193,
        "cash": 35934000000,
        "source": "SEC EDGAR (XBRL)",
        "ticker": "AAPL",
        "company": "Apple Inc.",
        "revenue": 416161000000,
        "currency": "USD",
        "net_income": 112010000000,
        "eps_diluted": 7.46,
        "gross_profit": 195201000000,
        "total_assets": 359241000000,
        "net_margin_pct": 26.92,
        "operating_income": 133050000000,
        "fiscal_period_end": "2025-09-27",
        "total_liabilities": 285508000000,
        "shareholders_equity": 73733000000
    },
    "meta": {
        "timestamp": "2026-06-12T01:42:23.258Z",
        "request_id": "f05d7d40-e734-406f-a3c5-3dfa03e7816f"
    },
    "status": "ok",
    "message": "Financials retrieved successfully",
    "success": true
}
```

### Concept

#### `GET /v1/concept` — Multi-year time series for one metric

**Parameters:**
- `ticker` (query, required, string) — Stock ticker Example: `AAPL`
- `metric` (query, optional, string) — revenue, net_income, assets, equity, eps_diluted… (default revenue) Example: `revenue`
- `limit` (query, optional, string) — Years (default 10, max 30) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/financials-api/v1/concept?ticker=AAPL&metric=revenue&limit=10"
```

**Response:**
```json
{
    "data": {
        "unit": "USD",
        "count": 10,
        "label": "Revenue from Contract with Customer, Excluding Assessed Tax",
        "metric": "revenue",
        "series": [
            {
                "value": 260174000000,
                "period_end": "2019-09-28",
                "fiscal_year": 2021
            },
            {
                "value": 91819000000,
                "period_end": "2019-12-28",
                "fiscal_year": 2020
            },
            {
                "value": 58313000000,
                "period_end": "2020-03-28",
                "fiscal_year": 2020
            },
            {
                "value": 59685000000,
                "period_end": "2020-06-27",
                "fiscal_year": 2020
            },
            {
                "value": 274515000000,
                "period_end": "2020-09-26",
                "fiscal_year": 2022
            },
            {
                "value": 365817000000,
                "period_end": "2021-09-25",
                "fiscal_year": 2023
            },
            {
                "value": 394328000000,
                "period_end": "2022-09-24",
                "fiscal_year": 2024
            },
            {
                "value": 383285000000,
                "period_end": "2023-09-30",
                "fiscal_year": 2025
            },
            {
                "value": 391035000000,
                "period_end": "2024-09-28",
                "fiscal_year": 20
…(truncated, see openapi.json for full schema)
```

### Company

#### `GET /v1/company` — Resolve a ticker to its SEC company

**Parameters:**
- `ticker` (query, required, string) — Stock ticker Example: `AAPL`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/financials-api/v1/company?ticker=AAPL"
```

**Response:**
```json
{
    "data": {
        "cik": 320193,
        "source": "SEC EDGAR",
        "ticker": "AAPL",
        "company": "Apple Inc.",
        "cik_padded": "CIK0000320193"
    },
    "meta": {
        "timestamp": "2026-06-12T01:42:23.428Z",
        "request_id": "740e5dd0-a605-4ad6-a9ed-05fbb5f22452"
    },
    "status": "ok",
    "message": "Company retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/financials-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "Look up a company by its ticker (ticker=AAPL). Figures are the latest annual (10-K) values reported to the SEC in USD. The concept endpoint accepts metric=revenue|gross_profit|operating_income|net_income|assets|liabilities|equity|cash|eps_diluted.",
        "source": "SEC EDGAR XBRL company-facts API (data.sec.gov, live)",
        "service": "financials-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/company": "Resolve a ticker to its SEC company (CIK, legal name).",
            "GET /v1/concept": "Multi-year time series for one metric (ticker=AAPL, metric=revenue).",
            "GET /v1/financials": "Latest annual key financials for a company (ticker=AAPL)."
        },
        "description": "Live fundamental financials for US public companies from the SEC's official XBRL data. financials = the latest annual key figures (revenue, gross profit, operating income, net income, total assets, total liabilities, shareholders' equity, cash, diluted EPS, net margin); concept = the multi-year time series for a single metric; company = resolves a ticker to its SEC company (CIK and legal name). Live, no key, nothing stored. Straight from a company's SEC filings — distinct from the quote, analyst, insider and SEC-filings (EDGAR) APIs.",
        "tickers_indexed": 10416,
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-12T01:42:23.514Z",
        "request_id": "e82cf0b6-a95
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/financials-api
OpenAPI spec: https://www.oanor.com/api/financials-api/openapi.json