Financial statements API

Retrieve structured financial statement data for companies, including income statements, balance sheets, and cash flow statements.

Requires authentication. Financial data is sourced from the financial_data schema in PostgreSQL.

Get income statement

Retrieve income statement data for multiple years. Endpoint: GET /companies/{symbol}/income-statement

Path parameters

symbol

string

required

Company ticker symbol (e.g., “AAPL”, “MSFT”)

Query parameters

years

integer

default:5

Number of years of data to retrieve (1-10)

Response

symbol

string

Company ticker

data

array

Array of annual income statement records

Show Income statement fields

date

string

Statement date

calendarYear

integer

Calendar year

period

string

Period type (typically “FY” for fiscal year)

revenue

number

Total revenue

costOfRevenue

number

Cost of goods sold (COGS)

grossProfit

number

Gross profit

grossProfitRatio

number

Gross profit margin

researchAndDevelopmentExpenses

number

R&D expenses

operatingExpenses

number

Total operating expenses

operatingIncome

number

Operating income

operatingIncomeRatio

number

Operating margin

ebitda

number

Earnings before interest, taxes, depreciation, and amortization

ebitdaRatio

number

EBITDA margin

netIncome

number

Net income

netIncomeRatio

number

Net profit margin

eps

number

Earnings per share (basic)

epsDiluted

number

Earnings per share (diluted)

Example

curl https://api.financeagent.com/companies/AAPL/income-statement?years=5 \
  -H "Authorization: Bearer YOUR_TOKEN"

Get balance sheet

Retrieve balance sheet data for multiple years. Endpoint: GET /companies/{symbol}/balance-sheet

Path parameters

symbol

string

required

Company ticker symbol

Query parameters

years

integer

default:5

Number of years of data (1-10)

Response

symbol

string

Company ticker

data

array

Array of annual balance sheet records

Show Balance sheet fields

date

string

Statement date

calendarYear

integer

Calendar year

totalAssets

number

Total assets

totalCurrentAssets

number

Current assets

cashAndCashEquivalents

number

Cash and equivalents

inventory

number

Inventory

propertyPlantEquipmentNet

number

PP&E (net)

totalLiabilities

number

Total liabilities

totalCurrentLiabilities

number

Current liabilities

longTermDebt

number

Long-term debt

totalStockholdersEquity

number

Shareholders’ equity

retainedEarnings

number

Retained earnings

Example

curl https://api.financeagent.com/companies/MSFT/balance-sheet?years=3 \
  -H "Authorization: Bearer YOUR_TOKEN"

Get cash flow statement

Retrieve cash flow statement data for multiple years. Endpoint: GET /companies/{symbol}/cash-flow

Path parameters

symbol

string

required

Company ticker symbol

Query parameters

years

integer

default:5

Number of years of data (1-10)

Response

symbol

string

Company ticker

data

array

Array of annual cash flow records

Show Cash flow fields

date

string

Statement date

calendarYear

integer

Calendar year

operatingCashFlow

number

Cash from operating activities

capitalExpenditure

number

Capital expenditures (CapEx)

freeCashFlow

number

Free cash flow (OCF - CapEx)

investingCashFlow

number

Cash from investing activities

financingCashFlow

number

Cash from financing activities

dividendsPaid

number

Dividends paid

stockBasedCompensation

number

Stock-based compensation

netCashProvidedByOperatingActivities

number

Net operating cash flow

changeInWorkingCapital

number

Working capital changes

Example

curl https://api.financeagent.com/companies/GOOGL/cash-flow?years=5 \
  -H "Authorization: Bearer YOUR_TOKEN"

Data source

Financial statement data is stored in PostgreSQL under the financial_data schema:

financial_data.income_statements - Income statement records
financial_data.balance_sheets - Balance sheet records
financial_data.cash_flow_statements - Cash flow records

Data is filtered to show only annual (FY) periods by default, with the most recent statement per calendar year.

Use cases

Revenue and profitability analysis

Track revenue growth, profit margins, and operating efficiency over time

Financial health assessment

Analyze assets, liabilities, debt levels, and equity structure

Cash generation analysis

Evaluate operating cash flow, free cash flow, and capital allocation

Multi-year trends

Compare financial metrics across multiple years to identify trends

Company info

Get company details and TTM metrics

SEC filings

Access complete 10-K and 10-Q filing documents

Overview

Endpoints

Python API

Financial statements

Financial statements API

Get income statement

Path parameters

Query parameters

Response

Example

Get balance sheet

Path parameters

Query parameters

Response

Example

Get cash flow statement

Path parameters

Query parameters

Response

Example

Data source

Use cases

Company info

SEC filings

Build docs developers (and LLMs) love

Overview

Endpoints

Python API

​Financial statements API

​Get income statement

​Path parameters

​Query parameters

​Response

​Example

​Get balance sheet

​Path parameters

​Query parameters

​Response

​Example

​Get cash flow statement

​Path parameters

​Query parameters

​Response

​Example

​Data source

​Use cases

​Related endpoints

Company info

SEC filings

Build docs developers (and LLMs) love

Financial statements API

Get income statement

Path parameters

Query parameters

Response

Example

Get balance sheet

Path parameters

Query parameters

Response

Example

Get cash flow statement

Path parameters

Query parameters

Response

Example

Data source

Use cases

Related endpoints