GET
/
financials
/
income-statements

​
👋 Overview

We have income statements for 16,000+ public companies, going back 30+ years.

Any data that you receive from our API is yours to keep. You may save the data to minimize repeat API calls.

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.

​
🚀 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. By default, limit is 10.

​
💻 Example

Income Statements
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')

Authorizations

X-API-KEY
string
headerrequired

API key for authentication.

Query Parameters

ticker
string
required

The ticker symbol.

period
enum<string>
required

The time period of the income statements.

Available options:
annual,
quarterly,
ttm
limit
integer

The maximum number of income statements to return.

Response

200 - application/json
income_statements
object[]
FactsBalance Sheets