Skip to main content
POST
Search specific financial metrics

Overview

This Line Items Search API lets you pull specific line items for a list of tickers by specifying a set of line_items in your request. Line items are financial data points that are found in the income statement, balance sheet, and cash flow statement. Examples of line items are revenue, net income, total debt, free cash flow, and so on. The purpose of this API is to let you easily get specific data points for a list of tickers in a single API request. You can also specify a start_date and end_date to filter the line items by a specific date range. Finally, you can specify a period, which must be one of "ttm", "annual", or "quarterly". For example, you can search for net_income and total_debt for NVDA and AAPL and receive the following response:

Coverage

Available Line Items

Code Example

Financials Search

Authorizations

X-API-KEY
string
header
required

API key for authentication.

Body

application/json
line_items
string[]
required

An array of line items to apply to the search.

Minimum array length: 1

The financial metric to search for.

tickers
string[]
required

An array of tickers to apply to the search.

Minimum array length: 1

The tickers to search for.

period
enum<string>
default:ttm

The time period for the financial data.

Available options:
annual,
quarterly,
ttm
limit
integer
default:1

The maximum number of results to return.

Required range: x >= 1

Response

Successful search response

search_results
object[]