Get income statements for a ticker.
The income statements API provides income statements for a given stock ticker.
Income statements are financial statements that provide information about a company’s revenues, expenses, and profits over a specific period.
You can filter the data by ticker
, period
, limit
, and cik
.
The period
parameter can be set to annual
, quarterly
, or ttm
(trailing twelve months). The limit
parameter is used to specify the number of statements to return.
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.
You can fetch a list of available tickers with a GET
request to:
https://api.financialdatasets.ai/financials/income-statements/tickers/
There are only 3 steps for making a successful API call:
X-API-KEY
.ticker
, period
and limit
to filter 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 annual
,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
API key for authentication.
The ticker symbol.
The time period of the income statements.
annual
, quarterly
, ttm
The maximum number of income statements to return.
The Central Index Key (CIK) of the company.
Income statements response
The response is of type object
.
Get income statements for a ticker.
The income statements API provides income statements for a given stock ticker.
Income statements are financial statements that provide information about a company’s revenues, expenses, and profits over a specific period.
You can filter the data by ticker
, period
, limit
, and cik
.
The period
parameter can be set to annual
, quarterly
, or ttm
(trailing twelve months). The limit
parameter is used to specify the number of statements to return.
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.
You can fetch a list of available tickers with a GET
request to:
https://api.financialdatasets.ai/financials/income-statements/tickers/
There are only 3 steps for making a successful API call:
X-API-KEY
.ticker
, period
and limit
to filter 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 annual
,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
API key for authentication.
The ticker symbol.
The time period of the income statements.
annual
, quarterly
, ttm
The maximum number of income statements to return.
The Central Index Key (CIK) of the company.
Income statements response
The response is of type object
.