Data API / Financial Data / Earnings

Get earnings snapshot

Reported earnings for one stock, actuals against estimates. Each entry carries report_period, fiscal_period, filing_date, filing_url and accession_number, a quarterly block with revenue, estimated_revenue, revenue_surprise and revenue_surprise_pct, the same trio for earnings_per_share, plus year-over-year change fields. It also returns signals: upstream-computed flags such as EPS_BEAT with a headline and the actual / estimate / surprise_pct behind it. ticker is required and it is the only parameter. Use it for what a company actually reported. For forward-looking consensus that has not happened yet use get_financial_analyst_estimates.

Параметры

запрос

tickerstringОбязательный
The ticker symbol.

Пример запроса

curl -G "https://openapi.felo.ai/v1/beta/financial/earnings" \
  --data-urlencode "ticker=<string>" \
  -H "Authorization: Bearer $FELO_API_KEY"

Ответ

Поля ответа

earningsobjectНеобязательный
tickerstringНеобязательный
The requested ticker symbol.
report_periodstringНеобязательный
Most recent report period found for the ticker.
fiscal_periodНеобязательный
Fiscal period label (e.g. 2025-Q4 or 2025-FY).
currencyНеобязательный
ISO currency code (e.g. USD).
quarterlyobjectНеобязательный
fiscal_periodНеобязательный
Fiscal period label (e.g. 2025-Q4 or 2025-FY).
currencyНеобязательный
ISO currency code (e.g. USD).
revenueНеобязательный
estimated_revenuenumberНеобязательный
Estimated revenue. Returned only when available.
revenue_surprisestringНеобязательный
Допустимые значения: BEAT · MISS · MEET
Revenue surprise classification versus estimate. Returned only when available.
earnings_per_shareНеобязательный
estimated_earnings_per_sharenumberНеобязательный
Estimated earnings per share. Returned only when available.
eps_surprisestringНеобязательный
Допустимые значения: BEAT · MISS · MEET
EPS surprise classification versus estimate. Returned only when available.
net_incomeНеобязательный
gross_profitНеобязательный
operating_incomeНеобязательный
weighted_average_sharesНеобязательный
weighted_average_shares_dilutedНеобязательный
cash_and_equivalentsНеобязательный
total_debtНеобязательный
total_assetsНеобязательный
total_liabilitiesНеобязательный
shareholders_equityНеобязательный
net_cash_flow_from_operationsНеобязательный
capital_expenditureНеобязательный
net_cash_flow_from_investingНеобязательный
net_cash_flow_from_financingНеобязательный
change_in_cash_and_equivalentsНеобязательный
free_cash_flowНеобязательный
revenue_chgnumberНеобязательный
Percentage change in revenue. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
net_income_chgnumberНеобязательный
Percentage change in net income. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
operating_income_chgnumberНеобязательный
Percentage change in operating income. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
gross_profit_chgnumberНеобязательный
Percentage change in gross profit. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
net_cash_flow_from_operations_chgnumberНеобязательный
Percentage change in net cash flow from operations. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
net_cash_flow_from_investing_chgnumberНеобязательный
Percentage change in net cash flow from investing. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
net_cash_flow_from_financing_chgnumberНеобязательный
Percentage change in net cash flow from financing. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
free_cash_flow_chgnumberНеобязательный
Percentage change in free cash flow. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
annualobjectНеобязательный
fiscal_periodНеобязательный
Fiscal period label (e.g. 2025-Q4 or 2025-FY).
currencyНеобязательный
ISO currency code (e.g. USD).
revenueНеобязательный
estimated_revenuenumberНеобязательный
Estimated revenue. Returned only when available.
revenue_surprisestringНеобязательный
Допустимые значения: BEAT · MISS · MEET
Revenue surprise classification versus estimate. Returned only when available.
earnings_per_shareНеобязательный
estimated_earnings_per_sharenumberНеобязательный
Estimated earnings per share. Returned only when available.
eps_surprisestringНеобязательный
Допустимые значения: BEAT · MISS · MEET
EPS surprise classification versus estimate. Returned only when available.
net_incomeНеобязательный
gross_profitНеобязательный
operating_incomeНеобязательный
weighted_average_sharesНеобязательный
weighted_average_shares_dilutedНеобязательный
cash_and_equivalentsНеобязательный
total_debtНеобязательный
total_assetsНеобязательный
total_liabilitiesНеобязательный
shareholders_equityНеобязательный
net_cash_flow_from_operationsНеобязательный
capital_expenditureНеобязательный
net_cash_flow_from_investingНеобязательный
net_cash_flow_from_financingНеобязательный
change_in_cash_and_equivalentsНеобязательный
free_cash_flowНеобязательный
revenue_chgnumberНеобязательный
Percentage change in revenue. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
net_income_chgnumberНеобязательный
Percentage change in net income. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
operating_income_chgnumberНеобязательный
Percentage change in operating income. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
gross_profit_chgnumberНеобязательный
Percentage change in gross profit. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
net_cash_flow_from_operations_chgnumberНеобязательный
Percentage change in net cash flow from operations. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
net_cash_flow_from_investing_chgnumberНеобязательный
Percentage change in net cash flow from investing. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
net_cash_flow_from_financing_chgnumberНеобязательный
Percentage change in net cash flow from financing. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.
free_cash_flow_chgnumberНеобязательный
Percentage change in free cash flow. QoQ in quarterly payload and YoY in annual payload. Returned only when calculable.