> ## Documentation Index
> Fetch the complete documentation index at: https://finance.chiefpriest.design/llms.txt
> Use this file to discover all available pages before exploring further.

# Financial Statements

> Get detailed financial statements including income, balance sheet, and cash flow

Get comprehensive financial statements from Financial Modeling Prep, including income statements, balance sheets, and cash flow statements with detailed line items.

## Parameters

<ParamField path="symbol" type="string" required>
  Stock symbol (e.g., AAPL, MSFT, GOOGL)
</ParamField>

<ParamField query="statement_type" type="string" default="income">
  Type of financial statement:

  * `income`: Income statement
  * `balance`: Balance sheet
  * `cash`: Cash flow statement
</ParamField>

<ParamField query="period" type="string" default="annual">
  Reporting period:

  * `annual`: Annual reports
  * `quarter`: Quarterly reports
</ParamField>

## Response

<ResponseField name="symbol" type="string">
  The stock symbol
</ResponseField>

<ResponseField name="statement_type" type="string">
  Type of statement returned
</ResponseField>

<ResponseField name="period" type="string">
  Reporting period (annual/quarter)
</ResponseField>

<ResponseField name="data" type="array">
  Array of financial statement data by period

  <Expandable title="Financial data properties (Income Statement)">
    <ResponseField name="date" type="string">
      Reporting date
    </ResponseField>

    <ResponseField name="symbol" type="string">
      Stock symbol
    </ResponseField>

    <ResponseField name="revenue" type="number">
      Total revenue
    </ResponseField>

    <ResponseField name="costOfRevenue" type="number">
      Cost of goods sold
    </ResponseField>

    <ResponseField name="grossProfit" type="number">
      Gross profit
    </ResponseField>

    <ResponseField name="operatingExpenses" type="number">
      Total operating expenses
    </ResponseField>

    <ResponseField name="operatingIncome" type="number">
      Operating income
    </ResponseField>

    <ResponseField name="netIncome" type="number">
      Net income
    </ResponseField>

    <ResponseField name="eps" type="number">
      Earnings per share
    </ResponseField>

    <ResponseField name="epsdiluted" type="number">
      Diluted earnings per share
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://stocks-dev.up.railway.app/api/v1/fmp/stock/AAPL/financials?statement_type=income&period=annual" \
    -H "X-API-Key: your_api_key"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('/api/v1/fmp/stock/AAPL/financials?statement_type=income&period=annual', {
    headers: {
      'X-API-Key': 'your_api_key'
    }
  });
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://stocks-dev.up.railway.app/api/v1/fmp/stock/AAPL/financials',
      params={
          'statement_type': 'income',
          'period': 'annual'
      },
      headers={'X-API-Key': 'your_api_key'}
  )
  data = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "symbol": "AAPL",
    "statement_type": "income",
    "period": "annual",
    "data": [
      {
        "date": "2023-09-30",
        "symbol": "AAPL",
        "revenue": 383285000000,
        "costOfRevenue": 214137000000,
        "grossProfit": 169148000000,
        "operatingExpenses": 55013000000,
        "operatingIncome": 114301000000,
        "netIncome": 96995000000,
        "eps": 6.13,
        "epsdiluted": 6.13,
        "weightedAverageShsOut": 15812547000,
        "weightedAverageShsOutDil": 15812547000
      },
      {
        "date": "2022-09-24",
        "symbol": "AAPL",
        "revenue": 394328000000,
        "costOfRevenue": 223546000000,
        "grossProfit": 170782000000,
        "operatingExpenses": 51345000000,
        "operatingIncome": 119437000000,
        "netIncome": 99803000000,
        "eps": 6.15,
        "epsdiluted": 6.15,
        "weightedAverageShsOut": 16215963000,
        "weightedAverageShsOutDil": 16215963000
      }
    ]
  }
  ```
</ResponseExample>

## Statement Types

### Income Statement

* Revenue and cost breakdown
* Operating expenses and income
* Net income and EPS
* Tax information

### Balance Sheet

* Assets (current and non-current)
* Liabilities (current and long-term)
* Shareholder equity
* Working capital metrics

### Cash Flow Statement

* Operating cash flow
* Investing activities
* Financing activities
* Free cash flow

## Use Cases

* **Financial Analysis**: Evaluate company performance
* **Valuation Models**: Build DCF and other models
* **Trend Analysis**: Track financial metrics over time
* **Comparative Analysis**: Compare companies within sectors

## Data Source

This endpoint uses Financial Modeling Prep (FMP) professional data with comprehensive coverage of US and international markets.

## Notes

* Annual data typically covers the last 5-10 years
* Quarterly data provides the most recent 8-12 quarters
* All monetary values are in the company's reporting currency
* Data is updated after earnings releases