---
title: "Stock financials (Pro)"
method: GET
path: "/api/v1/stocks/{ticker}/financials"
tags: ["Stocks"]
---

# Stock financials (Pro)

`GET /api/v1/stocks/{ticker}/financials`

## Request

- Base URL: `https://foliofact.com`
- URL: `https://foliofact.com/api/v1/stocks/{ticker}/financials`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`

Annual and quarterly financial series plus the valuation summary used by the screener.

## Path parameters

- `ticker` string, required

## Response `200`

Financial summary and series

- StockFinancials
  - `ticker` string, required
  - `name` string, nullable, required
  - `summary` FinancialSummary, required
    - `market_cap` integer, nullable, required: Market capitalization in whole US dollars.
    - `enterprise_value` integer, nullable, required: Enterprise value in whole US dollars.
    - `fcf_ev_yield_ttm` number, nullable, required: Free-cash-flow yield in percentage points on a 0-100 scale.
    - `ocf_ev_yield_ttm` number, nullable, required: Operating-cash-flow yield in percentage points on a 0-100 scale.
    - `fcf_ev_yield_year` number, nullable, required: Annual free-cash-flow yield in percentage points on a 0-100 scale.
    - `ocf_ev_yield_year` number, nullable, required: Annual operating-cash-flow yield in percentage points on a 0-100 scale.
    - `price` unknown, required
    - `price_reported_on` string, date, nullable, required
    - `price_basis_kind` 'daily_close' | 'intraday' | 'implied_13f', nullable, required
    - `valuation_observed_at` string, date-time, nullable, required: Exact observation time when an intraday price informed the derived valuation.
    - `valuation_label` string, nullable, required
    - `valuation_basis` ValuationBasis, required
      - `statement_on` string, date, nullable, required
      - `shares_on` string, date, nullable, required
      - `price_on` string, date, nullable, required
      - `measurement` string, nullable, required
      - `estimated` boolean, required
      - `description` string, required
      - `unavailable_reason` string, nullable, required
      - `ev_unavailable_reason` string, nullable, required
      - `accession_number` string, nullable, required
      - `source_url` string, nullable, required
      - `mapping_sources` string[], nullable, required
      - `calculation_version` string, required
      - `cash_flow_period` string, nullable, required
    - `revenue_growth_quarter` number, nullable, required: Revenue growth in percentage points on a 0-100 scale.
    - `revenue_growth_year` number, nullable, required: Revenue growth in percentage points on a 0-100 scale.
    - `revenue_growth_three_year_cagr` number, nullable, required: Revenue CAGR in percentage points on a 0-100 scale.
    - `share_reduction_quarter` number, nullable, required: Share-count reduction in percentage points on a 0-100 scale.
    - `share_reduction_year` number, nullable, required: Share-count reduction in percentage points on a 0-100 scale.
    - `share_reduction_two_years` number, nullable, required: Share-count reduction in percentage points on a 0-100 scale.
    - `share_reduction_three_years` number, nullable, required: Share-count reduction in percentage points on a 0-100 scale.
  - `series` object, required
    - `yearly` FinancialPoint[], required
      - `kind` 'quarter' | 'year', required
      - `key` string, required
      - `label` string, required
      - `end_on` string, date, nullable, required
      - `filed_on` string, date, nullable, required
      - `currency` string, required
      - `derived` boolean, required
      - `facts` FinancialFacts, required: Whole-unit SEC facts in the financial point's named currency; share fields are share counts.
        - `revenue` integer, nullable, required
        - `cost_of_revenue` integer, nullable, required
        - `gross_profit` integer, nullable, required
        - `operating_income` integer, nullable, required
        - `pretax_income` integer, nullable, required
        - `income_tax_expense` integer, nullable, required
        - `net_income` integer, nullable, required
        - `research_and_development` integer, nullable, required
        - `selling_general_admin` integer, nullable, required
        - `interest_expense` integer, nullable, required
        - `operating_cash_flow` integer, nullable, required
        - `capital_expenditures` integer, nullable, required
        - `share_repurchases` integer, nullable, required
        - `dividends_paid` integer, nullable, required
        - `depreciation_amortization` integer, nullable, required
        - `stock_based_compensation` integer, nullable, required
        - `investing_cash_flow` integer, nullable, required
        - `financing_cash_flow` integer, nullable, required
        - `total_assets` integer, nullable, required
        - `total_liabilities` integer, nullable, required
        - `stockholders_equity` integer, nullable, required
        - `cash_and_equivalents` integer, nullable, required
        - `long_term_debt` integer, nullable, required
        - `current_assets` integer, nullable, required
        - `current_liabilities` integer, nullable, required
        - `goodwill` integer, nullable, required
        - `inventory` integer, nullable, required
        - `basic_shares` integer, nullable, required
        - `diluted_shares` integer, nullable, required
        - `shares_outstanding` integer, nullable, required
    - `quarterly` FinancialPoint[], required
      - `kind` 'quarter' | 'year', required
      - `key` string, required
      - `label` string, required
      - `end_on` string, date, nullable, required
      - `filed_on` string, date, nullable, required
      - `currency` string, required
      - `derived` boolean, required
      - `facts` FinancialFacts, required: Whole-unit SEC facts in the financial point's named currency; share fields are share counts.
        - `revenue` integer, nullable, required
        - `cost_of_revenue` integer, nullable, required
        - `gross_profit` integer, nullable, required
        - `operating_income` integer, nullable, required
        - `pretax_income` integer, nullable, required
        - `income_tax_expense` integer, nullable, required
        - `net_income` integer, nullable, required
        - `research_and_development` integer, nullable, required
        - `selling_general_admin` integer, nullable, required
        - `interest_expense` integer, nullable, required
        - `operating_cash_flow` integer, nullable, required
        - `capital_expenditures` integer, nullable, required
        - `share_repurchases` integer, nullable, required
        - `dividends_paid` integer, nullable, required
        - `depreciation_amortization` integer, nullable, required
        - `stock_based_compensation` integer, nullable, required
        - `investing_cash_flow` integer, nullable, required
        - `financing_cash_flow` integer, nullable, required
        - `total_assets` integer, nullable, required
        - `total_liabilities` integer, nullable, required
        - `stockholders_equity` integer, nullable, required
        - `cash_and_equivalents` integer, nullable, required
        - `long_term_debt` integer, nullable, required
        - `current_assets` integer, nullable, required
        - `current_liabilities` integer, nullable, required
        - `goodwill` integer, nullable, required
        - `inventory` integer, nullable, required
        - `basic_shares` integer, nullable, required
        - `diluted_shares` integer, nullable, required
        - `shares_outstanding` integer, nullable, required

## Other responses

- `403`: Structured error
- `404`: Structured error
- `429`: Rate limit exceeded
- `default`: Structured error

---

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