Skip to main content
POST
Search specific financial metrics
Pull named financial line items across one or more companies in a single call. Body takes tickers and line_items (both required, both arrays), plus period (annual, quarterly or ttm) and limit. Returns search_results with one row per ticker and period carrying only the fields you asked for, alongside report_period, period and currency. Use it to build a comparison table without pulling three full statements per company. The item names are the same field names the statement tools return, so look one up there first if unsure. For everything about a single company use get_financial_financials.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

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[]