---
title: "Company Financials"
method: POST
path: "/v1/tools/company_financials"
---

# Company Financials

`POST /v1/tools/company_financials`

## Request

- Base URL: `https://unstuckapi.com`
- URL: `https://unstuckapi.com/v1/tools/company_financials`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Key financial numbers for a US public company by stock ticker or CIK: revenue, net income, diluted EPS, assets, liabilities, equity and cash (or any XBRL concept you name), latest annual and latest quarterly value with period, form and filing date. Data source: SEC EDGAR XBRL financial data (free public data; not affiliated with or endorsed by the SEC).

Price: $0.03 per call. Charged once per call that returns a result, including an empty result list. Failed calls are free.

## Request body

- object
  - `ticker_or_cik` string, required: Stock ticker (e.g. "AAPL", "BRK.B") or the company's numeric SEC CIK (e.g. "320193").
  - `metrics` string[]: XBRL concept names (us-gaap). Default: Revenues, NetIncomeLoss, EarningsPerShareDiluted, Assets, Liabilities, StockholdersEquity, CashAndCashEquivalentsAtCarryingValue. Revenues also checks RevenueFromContractWithCustomerExcludingAssessedTax and SalesRevenueNet.

## Response `200`

Success

- object
  - `tool` 'company_financials', required
  - `result` object, required
    - `source` 'SEC EDGAR', required
    - `company` string, nullable, required
    - `cik` string, required
    - `metrics` object[], required
      - `metric` string, required: Metric requested.
      - `tag` string, nullable, required: XBRL tag the values came from (null if the company never reported it).
      - `unit` string, nullable, required: e.g. "USD" or "USD/shares".
      - `latest_annual` object, nullable, required: Most recent full-year value (10-K/20-F/40-F).
        - `value` number, required
        - `start` string, nullable, required: Period start (null for point-in-time values like Assets).
        - `end` string, required: Period end (YYYY-MM-DD).
        - `fiscal_year` number, nullable, required
        - `fiscal_period` string, nullable, required: "FY", "Q1", "Q2", "Q3".
        - `form` string, required
        - `filed` string, required
      - `latest_quarter` object, nullable, required: Most recent single-quarter value from a 10-Q (balance-sheet items: as of quarter end).
        - `value` number, required
        - `start` string, nullable, required: Period start (null for point-in-time values like Assets).
        - `end` string, required: Period end (YYYY-MM-DD).
        - `fiscal_year` number, nullable, required
        - `fiscal_period` string, nullable, required: "FY", "Q1", "Q2", "Q3".
        - `form` string, required
        - `filed` string, required
  - `charged_usd` number, required
  - `balance_usd` number, required

## Other responses

- `400`: Invalid JSON or input. Not charged.
- `401`: Paid tool without a valid API key.
- `402`: Balance too low for this call. Not charged.
- `404`: Unknown tool.
- `422`: The tool failed. Not charged.
- `429`: Rate limited, free tries used up, or the uncharged-result limit reached. See Retry-After.

---

[API](https://skmtc.dev/unstuckapi/apis/unstuck-api.md) · [All operations](https://skmtc.dev/unstuckapi/apis/unstuck-api/llms.txt) · [OpenAPI document](https://skmtc.dev/unstuckapi/apis/unstuck-api/revisions/ef3ec951224f?raw)