GET /benzinga/v1/earnings — polygon-api

latestOpenAPI 3.0.32026-08-101461131.1 MB

ad6f143e43aa

benzinga9

crypto:aggregates7

crypto:last:trade1

crypto:open-close1

crypto:snapshot4

crypto:trades2

etfglobal5

fable2

fed4

financials4

futures:aggregates1

fx:aggregates7

fx:conversion1

fx:last:quote1

fx:quotes1

fx:snapshot3

fx:trades1

global_crypto1

global_forex1

indices:aggregates6

indices:snapshot1

options:aggregates6

options:last:trade1

options:open-close1

options:quotes1

options:snapshot2

options:trades1

reference14

reference:conditions1

reference:dividends1

reference:exchanges1

reference:news1

reference:options:contract1

reference:options:contracts:list1

reference:related:companies1

reference:sec:filing1

reference:sec:filing:file1

reference:sec:filing:files1

reference:sec:filings1

reference:stocks2

reference:stocks:ipos1

reference:stocks:market2

reference:tickers:get2

reference:tickers:list1

reference:tickers:types1

stocks:aggregates7

stocks:last:quote1

stocks:last:trade1

stocks:open-close2

stocks:quotes2

stocks:snapshot3

stocks:trades2

tmx1

us_futures8

us_options3

us_stocks_all2

us_stocks_reference3

benzinga

This table contains earnings data from Benzinga, tracking both actual and estimated financial metrics for publicly traded companies. It includes EPS and revenue figures with surprise calculations, along with metadata like fiscal periods, company identifiers, and reporting timestamps.

get/benzinga/v1/earnings

Query parameters

datestring

The calendar date (formatted as YYYY-MM-DD) when the earnings are scheduled or were reported.

date.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list.

date.gtstring

Filter greater than the value.

date.gtestring

Filter greater than or equal to the value.

date.ltstring

Filter less than the value.

date.ltestring

Filter less than or equal to the value.

tickerstring

The stock symbol of the company reporting earnings.

ticker.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list.

ticker.gtstring

Filter greater than the value.

ticker.gtestring

Filter greater than or equal to the value.

ticker.ltstring

Filter less than the value.

ticker.ltestring

Filter less than or equal to the value.

importanceinteger

A subjective indicator of the importance of the event, on a scale from 0 (lowest) to 5 (highest). Value must be an integer.

importance.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list. Value must be an integer.

importance.gtinteger

Filter greater than the value. Value must be an integer.

importance.gteinteger

Filter greater than or equal to the value. Value must be an integer.

importance.ltinteger

Filter less than the value. Value must be an integer.

importance.lteinteger

Filter less than or equal to the value. Value must be an integer.

last_updatedstring

The timestamp (formatted as an ISO 8601 timestamp) when the record was last updated in the system. Value must be an integer timestamp in seconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').

last_updated.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list. Value must be an integer timestamp in seconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').

last_updated.gtstring

Filter greater than the value. Value must be an integer timestamp in seconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').

last_updated.gtestring

Filter greater than or equal to the value. Value must be an integer timestamp in seconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').

last_updated.ltstring

Filter less than the value. Value must be an integer timestamp in seconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').

last_updated.ltestring

Filter less than or equal to the value. Value must be an integer timestamp in seconds, formatted 'yyyy-mm-dd', or ISO 8601/RFC 3339 (e.g. '2024-05-28T20:27:41Z').

date_statusstring

Indicates whether the date of the earnings report has been confirmed. Possible values include: projected, confirmed.

date_status.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list.

date_status.gtstring

Filter greater than the value.

date_status.gtestring

Filter greater than or equal to the value.

date_status.ltstring

Filter less than the value.

date_status.ltestring

Filter less than or equal to the value.

eps_surprise_percentnumber double

The percentage difference between the actual and estimated EPS. Value must be a floating point number.

eps_surprise_percent.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list. Value must be a floating point number.

eps_surprise_percent.gtnumber double

Filter greater than the value. Value must be a floating point number.

eps_surprise_percent.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

eps_surprise_percent.ltnumber double

Filter less than the value. Value must be a floating point number.

eps_surprise_percent.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

revenue_surprise_percentnumber double

The percentage difference between the actual and estimated revenue. Value must be a floating point number.

revenue_surprise_percent.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list. Value must be a floating point number.

revenue_surprise_percent.gtnumber double

Filter greater than the value. Value must be a floating point number.

revenue_surprise_percent.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

revenue_surprise_percent.ltnumber double

Filter less than the value. Value must be a floating point number.

revenue_surprise_percent.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

fiscal_yearinteger

The fiscal year in which the earnings period falls. Value must be an integer.

fiscal_year.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list. Value must be an integer.

fiscal_year.gtinteger

Filter greater than the value. Value must be an integer.

fiscal_year.gteinteger

Filter greater than or equal to the value. Value must be an integer.

fiscal_year.ltinteger

Filter less than the value. Value must be an integer.

fiscal_year.lteinteger

Filter less than or equal to the value. Value must be an integer.

fiscal_periodstring

The fiscal period for which the earnings are reported. Examples include: Q1, Q2, H1, FY.

fiscal_period.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list.

fiscal_period.gtstring

Filter greater than the value.

fiscal_period.gtestring

Filter greater than or equal to the value.

fiscal_period.ltstring

Filter less than the value.

fiscal_period.ltestring

Filter less than or equal to the value.

limitinteger

Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '50000'.

sortstring

A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'last_updated' if not specified. The sort order defaults to 'desc' if not specified.

Response

A list of results.

next_urlstring

If present, this value can be used to fetch the next page.

request_idstring required

A request id assigned by the server.

status'OK' required

The status of this request's response.