Skip to content
Fundamentals

Get stock earnings report forecast list

Query the specified underlying's earnings report forecasts and related corporate actions (such as reverse stock split, stock split, dividend distribution plan, code change) within a date range, including estimated EPS, estimated revenue, and other data.

GEThttps://api.lbkrs.com/stock/activity/stock_financial_report_date

Parameters

counter_idstringqueryRequired

Underlying code, e.g. ST/US/AAPL

start_datestringqueryRequired

Start time, format 20241101

end_datestringquery

End time, format 20241101 (inclusive; pass the previous day to exclude it). If omitted, the end date is unrestricted

sizeintegerquery

Maximum number of items to return, default 100

Responses

HTTP 200The request succeeded. The response body contains the result of the “Get stock earnings report forecast list” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
listarray<object>

Earnings forecast / corporate action list

Child attributes
idstring

Record id

datestring

Date, e.g. 20260129

date_typestring

Date type (e.g. pre-market, post-market)

act_titlestring

Event title, e.g. “Estimated earnings release”

act_descstring

Event summary, e.g. “FY2026 Q1 results disclosure”

securityobject

Underlying info (observed to always be null in the test environment)

Child attributes
counter_idstring
marketstring
namestring
actionstring

Unique event identifier: ReportDate earnings forecast release, ReverseStockSplit reverse stock split, StockSplit stock split, DividendExDate dividend distribution plan, ChangeCode code change

ReportDateReverseStockSplitStockSplitDividendExDateChangeCode

date_strstring

Date display text, e.g. “2026.01.29 (ET)”

date_zonestring

Date time-zone display text, e.g. “(ET)”

quoteobject

Associated quote info (observed to always be null in the test environment)

Child attributes
counter_idstring
namestring
last_donestring
changestring
trade_statusinteger
latencyboolean
duplicateboolean
introstring
profilestring
codestring
marketstring
labelsarray<string>
timestampstring

Timestamp (seconds)

chart_uidstring

Associated chart id

data_kvarray<object>

Supplementary key-value data (e.g. estimated EPS, estimated revenue)

Child attributes
keystring
valuestring

Display value, e.g. “$2.6708”, "--" when no data

typestring

Value type: estimate_eps estimated EPS, estimate_revenue estimated revenue

estimate_epsestimate_revenue

value_rawstring
iconstring

Icon URL

urlstring
regionstring
starinteger
currencystring

Currency unit for data_kv

liveobject

Associated livestream info (observed to always be null in the test environment)

Child attributes
idinteger
statusinteger
started_atinteger
counter_idsarray<string>
namestring
iconstring
bookedboolean
act_typestring

Event type display text, observed to be identical to act_title

extobject

Extension info, structure not fixed; for earnings forecast events, observed to be ext.financial_report.{fiscal_year,market_time,period,period_type} (fiscal year, pre-/post-market, quarter, period type)

totalstring

Total count (observed in the test environment to always return "0" even when list is non-empty; documented as-is)

HTTP 400The service rejected the request because a business rule or input validation failed. Review the business codes and correct the request before retrying.
codeintegerrequired

Business status code, 0 indicates success

messagestringrequired

Human-readable result or error message.

Whale Docs