Skip to content
Financials and Earnings

Get SEC filing earnings comparison

Query the revenue, EBIT, and EPS for the reporting period covered by an SEC filing (such as an 8-K earnings release) of the specified underlying. Returns the reported values, year-over-year changes, and the comparison with market consensus estimates, used to show an earnings comparison table above the body of a US SEC filing news detail page.

When the business code is not 0 or all three metrics are missing, the Broker App hides the block. When a metric has no estimate, its estimate-related fields are empty strings.

GEThttps://api.lbkrs.com/stock-info/sec-finview

Parameters

counter_idstringqueryRequired

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

uidstringqueryRequired

Unique ID of the SEC filing news item, i.e. the notice ID from the notice detail

Responses

HTTP 200The request succeeded. The response body contains the result of the “Get SEC filing earnings comparison” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
reportstring

Report period type, such as qf for a quarterly report

fiscal_yearinteger

Fiscal year, such as 2025

fiscal_periodstring

Fiscal quarter number, such as 4 for the fourth fiscal quarter

currencystring

Currency of the metric amounts, such as USD

revenueobject

Comparison of a single financial metric’s reported value against the market estimate

Child attributes
valuestring

Reported value as a decimal string, in the response currency (EPS is a per-share amount); empty string when unavailable

yoystring

Year-over-year change of the reported value as a percentage string (0.82 means 0.82%); empty string when unavailable

est_valuestring

Market consensus estimate, same format as value; empty string when no estimate is available

est_yoystring

Year-over-year change implied by the estimate, as a percentage string; empty string when no estimate is available

cmpstring

Result of comparing the reported value with the estimate:

  • beat_est - Beat the estimate
  • met_est - Met the estimate
  • miss_est - Missed the estimate
  • Empty string - No estimate available, so no comparison
Values
beat_est
met_est
miss_est
cmp_descstring

Localized display text for cmp, such as “Missed estimate”; empty string when cmp is empty. Whether to display it is up to the Broker

ebitobject

Comparison of a single financial metric’s reported value against the market estimate

Child attributes
valuestring

Reported value as a decimal string, in the response currency (EPS is a per-share amount); empty string when unavailable

yoystring

Year-over-year change of the reported value as a percentage string (0.82 means 0.82%); empty string when unavailable

est_valuestring

Market consensus estimate, same format as value; empty string when no estimate is available

est_yoystring

Year-over-year change implied by the estimate, as a percentage string; empty string when no estimate is available

cmpstring

Result of comparing the reported value with the estimate:

  • beat_est - Beat the estimate
  • met_est - Met the estimate
  • miss_est - Missed the estimate
  • Empty string - No estimate available, so no comparison
Values
beat_est
met_est
miss_est
cmp_descstring

Localized display text for cmp, such as “Missed estimate”; empty string when cmp is empty. Whether to display it is up to the Broker

epsobject

Comparison of a single financial metric’s reported value against the market estimate

Child attributes
valuestring

Reported value as a decimal string, in the response currency (EPS is a per-share amount); empty string when unavailable

yoystring

Year-over-year change of the reported value as a percentage string (0.82 means 0.82%); empty string when unavailable

est_valuestring

Market consensus estimate, same format as value; empty string when no estimate is available

est_yoystring

Year-over-year change implied by the estimate, as a percentage string; empty string when no estimate is available

cmpstring

Result of comparing the reported value with the estimate:

  • beat_est - Beat the estimate
  • met_est - Met the estimate
  • miss_est - Missed the estimate
  • Empty string - No estimate available, so no comparison
Values
beat_est
met_est
miss_est
cmp_descstring

Localized display text for cmp, such as “Missed estimate”; empty string when cmp is empty. Whether to display it is up to the Broker

Whale Docs