Financial Data
Company fundamentals, financial statements, market prices and economic data.
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.
- Type: array string[] 1…line
_items requiredAn array of line items to apply to the search.
- Type: array string[] 1…tickersrequired
An array of tickers to apply to the search.
- Type: integerlimitmin:1
The maximum number of results to return.
- Type: string enumperiod
The time period for the financial data.
values- annual
- quarterly
- ttm
- Type: object · FinancialsSearchResponse200
Successful search response
- Type: array object[]search
_results - currencyType: string
The currency of the financial data.
- periodType: string enum
The time period of the financial data.
values- annual
- quarterly
- ttm
- reportType: string Format: date
_period The reporting period of the financial data.
- tickerType: string
The ticker symbol of the company.
- propertyType: string
Name Additional financial metrics based on the search criteria.
application/json - Type: object · ErrorResponse400
Bad request
- Type: stringerror
A short error message.
- Type: stringmessage
A more detailed error message.
application/json - Type: object · ErrorResponse401
Unauthorized
- Type: stringerror
A short error message.
- Type: stringmessage
A more detailed error message.
application/json - Type: object · ErrorResponse402
The request requires a paid subscription
- Type: stringerror
A short error message.
- Type: stringmessage
A more detailed error message.
application/json - 403
The account is not permitted to perform this operation.
- Type: object · ErrorResponse404
The specified resource was not found
- Type: stringerror
A short error message.
- Type: stringmessage
A more detailed error message.
application/json - 429
A request or spending limit has been reached.
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
The operation failed. Keep the response request ID when contacting Felo support.
curl https://openapi.felo.ai/v1/beta/financial/financials/search/line-items \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"line_items": [
""
],
"tickers": [
""
],
"period": "ttm",
"limit": 1
}'
{
"search_results": [
{
"ticker": "string",
"report_period": "2026-09-30",
"period": "annual",
"currency": "string",
"additionalProperty": "string"
}
]
}