Income Statements

​

👋 Overview

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.

​

📊 Available Tickers

You can fetch a list of available tickers with a GET request to: https://api.financialdatasets.ai/financials/income-statements/tickers/

​

🚀 Getting Started

There are only 3 steps for making a successful API call:

1. Add your API key to the header of the request as X-API-KEY.
2. Add query params like ticker, period and limit to filter the data.
3. Execute the API request.

Note: ticker and period are required. Alternatively, you can use cik instead of ticker as a company identifier in your request. By default, limit is 4.

​

💻 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/income-statements'
    f'?ticker={ticker}'
    f'&period={period}'
    f'&limit={limit}'
)

# make API request
response = requests.get(url, headers=headers)

# parse income_statements from the response
income_statements = response.json().get('income_statements')