Get Started
Our APIs
- Company
- Crypto
- Earnings
- Financial Metrics
- Financial Statements
- Insider Trades
- Institutional Ownership
- News
- Prices
- Search
- SEC Filings
- Segmented Financials
All Financial Statements
Get all financial statements for a ticker.
curl --request GET \
--url https://api.financialdatasets.ai/financials \
--header 'X-API-KEY: <api-key>'
{
"financials": {
"income_statements": [
{
"ticker": "<string>",
"calendar_date": "2023-12-25",
"report_period": "2023-12-25",
"period": "quarterly",
"currency": "<string>",
"revenue": 123,
"cost_of_revenue": 123,
"gross_profit": 123,
"operating_expense": 123,
"selling_general_and_administrative_expenses": 123,
"research_and_development": 123,
"operating_income": 123,
"interest_expense": 123,
"ebit": 123,
"income_tax_expense": 123,
"net_income_discontinued_operations": 123,
"net_income_non_controlling_interests": 123,
"net_income": 123,
"net_income_common_stock": 123,
"preferred_dividends_impact": 123,
"consolidated_income": 123,
"earnings_per_share": 123,
"earnings_per_share_diluted": 123,
"dividends_per_common_share": 123,
"weighted_average_shares": 123,
"weighted_average_shares_diluted": 123
}
],
"balance_sheets": [
{
"ticker": "<string>",
"calendar_date": "2023-12-25",
"report_period": "2023-12-25",
"period": "quarterly",
"currency": "<string>",
"total_assets": 123,
"current_assets": 123,
"cash_and_equivalents": 123,
"inventory": 123,
"current_investments": 123,
"trade_and_non_trade_receivables": 123,
"non_current_assets": 123,
"property_plant_and_equipment": 123,
"goodwill_and_intangible_assets": 123,
"investments": 123,
"non_current_investments": 123,
"outstanding_shares": 123,
"tax_assets": 123,
"total_liabilities": 123,
"current_liabilities": 123,
"current_debt": 123,
"trade_and_non_trade_payables": 123,
"deferred_revenue": 123,
"deposit_liabilities": 123,
"non_current_liabilities": 123,
"non_current_debt": 123,
"tax_liabilities": 123,
"shareholders_equity": 123,
"retained_earnings": 123,
"accumulated_other_comprehensive_income": 123,
"total_debt": 123
}
],
"cash_flow_statements": [
{
"ticker": "<string>",
"calendar_date": "2023-12-25",
"report_period": "2023-12-25",
"period": "quarterly",
"currency": "<string>",
"net_income": 123,
"depreciation_and_amortization": 123,
"share_based_compensation": 123,
"net_cash_flow_from_operations": 123,
"capital_expenditure": 123,
"business_acquisitions_and_disposals": 123,
"investment_acquisitions_and_disposals": 123,
"net_cash_flow_from_investing": 123,
"issuance_or_repayment_of_debt_securities": 123,
"issuance_or_purchase_of_equity_shares": 123,
"dividends_and_other_cash_distributions": 123,
"net_cash_flow_from_financing": 123,
"change_in_cash_and_equivalents": 123,
"effect_of_exchange_rate_changes": 123,
"ending_cash_balance": 123,
"free_cash_flow": 123
}
]
}
}
👋 Overview
This endpoint aggregates all financial statements for a ticker into a single API call.
So, instead of calling 3 endpoints to get income statements, balance sheets, and cash flow statements, you can call this endpoint once and get all financial statements in one go.
The endpoint returns the following financial statements:
To get started, please create an account and grab your API key at financialdatasets.ai.
You will use the API key to authenticate your API requests.
📊 Available Tickers
You can fetch a list of available tickers with a GET
request to:
https://api.financialdatasets.ai/financials/tickers/
🚀 Getting Started
There are only 3 steps for making a successful API call:
- Add your API key to the header of the request as
X-API-KEY
. - Add query params like
ticker
,period
andlimit
to filter the data. - Execute the API request.
🔎 Filtering the Data
You can filter the data by ticker
, period
, limit
, and report_period
.
Note: ticker
and period
are required. Alternatively, you can use cik
instead of ticker
as a company identifier in your request.
By default, period
is ttm
,limit
is 4
, and report_period
is null
.
The period
parameter can be set to annual
, quarterly
, or ttm
(trailing twelve months). The limit
parameter is used to specify the number of periods to return.
The report_period
parameter is used to specify the date of the statement. For example, you can include filters like report_period_lte=2024-09-30
and report_period_gte=2024-01-01
to get statements between January 1, 2024 and September 30, 2024.
The available report_period
operations are:
report_period_lte
report_period_lt
report_period_gte
report_period_gt
report_period
💻 Example
import requests
# add your API key to the headers
headers = {
"X-API-KEY": "your_api_key_here"
}
# set your query params
ticker = 'NVDA' # stock ticker
period = 'annual' # possible values are 'annual', 'quarterly', or 'ttm'
limit = 30 # number of statements to return
# create the URL
url = (
f'https://api.financialdatasets.ai/financials/'
f'?ticker={ticker}'
f'&period={period}'
f'&limit={limit}'
)
# make API request
response = requests.get(url, headers=headers)
# parse financials from the response
financials = response.json().get('financials')
# get income statements
income_statements = financials.get('income_statements')
# get balance sheets
balance_sheets = financials.get('balance_sheets')
# get cash flow statements
cash_flow_statements = financials.get('cash_flow_statements')
💻 Example (with report_period)
import requests
# add your API key to the headers
headers = {
"X-API-KEY": "your_api_key_here"
}
# set your query params
ticker = 'NVDA'
period = 'annual'
limit = 100
report_period_lte = '2024-01-01' # end date
report_period_gte = '2020-01-01' # start date
# create the URL
url = (
f'https://api.financialdatasets.ai/financials/'
f'?ticker={ticker}'
f'&period={period}'
f'&limit={limit}'
f'&report_period_lte={report_period_lte}'
f'&report_period_gte={report_period_gte}'
)
# make API request
response = requests.get(url, headers=headers)
# parse financials from the response
financials = response.json().get('financials')
Authorizations
API key for authentication.
Query Parameters
The ticker symbol.
The time period of the financial statements.
annual
, quarterly
, ttm
The maximum number of financial statements to return.
The Central Index Key (CIK) of the company.
Response
The ticker symbol.
The date of the income statement.
The reporting period of the income statement.
The time period of the income statement.
quarterly
, ttm
, annual
The currency in which the financial data is reported.
The total revenue of the company.
The cost of revenue of the company.
The gross profit of the company.
The operating expenses of the company.
The selling, general, and administrative expenses of the company.
The research and development expenses of the company.
The operating income of the company.
The interest expenses of the company.
The earnings before interest and taxes of the company.
The income tax expenses of the company.
The net income from discontinued operations of the company.
The net income from non-controlling interests of the company.
The net income of the company.
The net income available to common stockholders of the company.
The impact of preferred dividends on the net income of the company.
The consolidated income of the company.
The earnings per share of the company.
The diluted earnings per share of the company.
The dividends per common share of the company.
The weighted average shares of the company.
The diluted weighted average shares of the company.
The ticker symbol.
The date of the balance sheet.
The reporting period of the balance sheet.
The time period of the balance sheet.
quarterly
, ttm
, annual
The currency in which the financial data is reported.
The total assets of the company.
The current assets of the company.
The cash and equivalents of the company.
The inventory of the company.
The current investments of the company.
The trade and non-trade receivables of the company.
The non-current assets of the company.
The property, plant, and equipment of the company.
The goodwill and intangible assets of the company.
The investments of the company.
The non-current investments of the company.
The outstanding shares of the company.
The tax assets of the company.
The total liabilities of the company.
The current liabilities of the company.
The current debt of the company.
The trade and non-trade payables of the company.
The deferred revenue of the company.
The deposit liabilities of the company.
The non-current liabilities of the company.
The non-current debt of the company.
The tax liabilities of the company.
The shareholders' equity of the company.
The retained earnings of the company.
The accumulated other comprehensive income of the company.
The total debt of the company.
The ticker symbol.
The date of the cash flow statement.
The reporting period of the cash flow statement.
The time period of the cash flow statement.
quarterly
, ttm
, annual
The currency in which the financial data is reported.
The net income of the company.
The depreciation and amortization of the company.
The share-based compensation of the company.
The net cash flow from operations of the company.
The capital expenditure of the company.
The business acquisitions and disposals of the company.
The investment acquisitions and disposals of the company.
The net cash flow from investing of the company.
The issuance or repayment of debt securities of the company.
The issuance or purchase of equity shares of the company.
The dividends and other cash distributions of the company.
The net cash flow from financing of the company.
The change in cash and equivalents of the company.
The effect of exchange rate changes of the company.
The ending cash balance of the company.
The free cash flow of the company.
curl --request GET \
--url https://api.financialdatasets.ai/financials \
--header 'X-API-KEY: <api-key>'
{
"financials": {
"income_statements": [
{
"ticker": "<string>",
"calendar_date": "2023-12-25",
"report_period": "2023-12-25",
"period": "quarterly",
"currency": "<string>",
"revenue": 123,
"cost_of_revenue": 123,
"gross_profit": 123,
"operating_expense": 123,
"selling_general_and_administrative_expenses": 123,
"research_and_development": 123,
"operating_income": 123,
"interest_expense": 123,
"ebit": 123,
"income_tax_expense": 123,
"net_income_discontinued_operations": 123,
"net_income_non_controlling_interests": 123,
"net_income": 123,
"net_income_common_stock": 123,
"preferred_dividends_impact": 123,
"consolidated_income": 123,
"earnings_per_share": 123,
"earnings_per_share_diluted": 123,
"dividends_per_common_share": 123,
"weighted_average_shares": 123,
"weighted_average_shares_diluted": 123
}
],
"balance_sheets": [
{
"ticker": "<string>",
"calendar_date": "2023-12-25",
"report_period": "2023-12-25",
"period": "quarterly",
"currency": "<string>",
"total_assets": 123,
"current_assets": 123,
"cash_and_equivalents": 123,
"inventory": 123,
"current_investments": 123,
"trade_and_non_trade_receivables": 123,
"non_current_assets": 123,
"property_plant_and_equipment": 123,
"goodwill_and_intangible_assets": 123,
"investments": 123,
"non_current_investments": 123,
"outstanding_shares": 123,
"tax_assets": 123,
"total_liabilities": 123,
"current_liabilities": 123,
"current_debt": 123,
"trade_and_non_trade_payables": 123,
"deferred_revenue": 123,
"deposit_liabilities": 123,
"non_current_liabilities": 123,
"non_current_debt": 123,
"tax_liabilities": 123,
"shareholders_equity": 123,
"retained_earnings": 123,
"accumulated_other_comprehensive_income": 123,
"total_debt": 123
}
],
"cash_flow_statements": [
{
"ticker": "<string>",
"calendar_date": "2023-12-25",
"report_period": "2023-12-25",
"period": "quarterly",
"currency": "<string>",
"net_income": 123,
"depreciation_and_amortization": 123,
"share_based_compensation": 123,
"net_cash_flow_from_operations": 123,
"capital_expenditure": 123,
"business_acquisitions_and_disposals": 123,
"investment_acquisitions_and_disposals": 123,
"net_cash_flow_from_investing": 123,
"issuance_or_repayment_of_debt_securities": 123,
"issuance_or_purchase_of_equity_shares": 123,
"dividends_and_other_cash_distributions": 123,
"net_cash_flow_from_financing": 123,
"change_in_cash_and_equivalents": 123,
"effect_of_exchange_rate_changes": 123,
"ending_cash_balance": 123,
"free_cash_flow": 123
}
]
}
}