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.
Pricing reference
- Metering: Fixed successful-request cost basis.
- Reference request estimate: USD 0.02.
- Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount.
Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.
- 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 · ResponseE40Feb4D3D6B_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 - 400
The request could not be processed. Check the request parameters.
- 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 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
Error response; upstream passthrough responses may use provider formats
application/json
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-10-23",
"period": "annual",
"currency": "string",
"additionalProperty": "string"
}
]
}