Earnings
GET
/benzinga/v1/earnings
Retrieve structured historical and upcoming earnings announcements for publicly traded companies, including key metrics such as earnings per share (EPS), revenue, and analyst estimates. Each record includes reported values, estimated figures, and surprise metrics, with optional context like fiscal period, confirmation status, and event importance. Data is timestamped, filterable by ticker and date, and includes both the actual and prior-period values. This endpoint provides clean, developer-friendly access to earnings events for use in analytics, automation, or investor tools.
Use Cases: Earnings calendar tracking, financial modeling, event-driven alerts, market research.
Query Parameters
date
string
The calendar date (formatted as YYYY-MM-DD) when the earnings are scheduled or were reported.
ticker
string
The stock symbol of the company reporting earnings.
importance
integer
A subjective indicator of the importance of the event, on a scale from 0 (lowest) to 5 (highest). Value must be an integer.
last_updated
string
The timestamp (formatted as an ISO 8601 timestamp) when the record was last updated in the system.
date_status
string
Indicates whether the date of the earnings report has been confirmed. Possible values include: projected, confirmed.
eps_surprise_percent
number
The percentage difference between the actual and estimated EPS. Value must be a floating point number.
revenue_surprise_percent
number
The percentage difference between the actual and estimated revenue. Value must be a floating point number.
fiscal_year
integer
The fiscal year in which the earnings period falls. Value must be an integer.
fiscal_period
string
The fiscal period for which the earnings are reported. Examples include: Q1, Q2, H1, FY.
limit
integer
Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '50000'.
sort
string
A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'date' if not specified. The sort order defaults to 'desc' if not specified.
Response Attributes
next_url
string
optional
If present, this value can be used to fetch the next page.
request_id
string
A request id assigned by the server.
results
array (object)
The results for this request.
actual_eps
number
optional
The actual earnings per share (EPS) reported by the company for the given period.
actual_revenue
number
optional
The actual revenue reported by the company for the given fiscal period.
benzinga_id
string
optional
The identifer used by Benzinga for this record.
company_name
string
optional
The name of the company releasing earnings.
currency
string
optional
The ISO 4217 currency code indicating the denomination in which the figures are reported.
date
string
optional
The calendar date (formatted as YYYY-MM-DD) when the earnings are scheduled or were reported.
date_status
string
optional
Indicates whether the date of the earnings report has been confirmed. Possible values include: projected, confirmed.
eps_method
string
optional
The methodology of the EPS figure. Possible values are gaap (standardized financials under Generally Accepted Accounting Principles), ffo (Funds From Operations, a non-GAAP metric commonly used to assess the operating performance of REITs), and adj (adjusted, non-GAAP).
eps_surprise
number
optional
The difference between the actual and estimated EPS.
eps_surprise_percent
number
optional
The percentage difference between the actual and estimated EPS.
estimated_eps
number
optional
The analyst consensus estimate for earnings per share (EPS) for the given period.
estimated_revenue
number
optional
The analyst consensus estimate for the company's revenue in the given period.
fiscal_period
string
optional
The fiscal period for which the earnings are reported. Examples include: Q1, Q2, H1, FY.
fiscal_year
integer
optional
The fiscal year in which the earnings period falls.
importance
integer
optional
A subjective indicator of the importance of the event, on a scale from 0 (lowest) to 5 (highest).
last_updated
string
optional
The timestamp (formatted as an ISO 8601 timestamp) when the record was last updated in the system.
notes
string
optional
Additional context, commentary, or clarifying notes related to the earnings event.
previous_eps
number
optional
The company's reported earnings per share (EPS) for the previous comparable period.
previous_revenue
number
optional
The company's revenue for the previous comparable fiscal period.
revenue_method
string
optional
The methodology of the revenue figure. Possible values are gaap (standardized financials under Generally Accepted Accounting Principles), adj (adjusted, non-GAAP figures that exclude certain items like one-time charges or divestitures), and rental (revenue specifically derived from rental operations, typically used by REITs, leasing companies, or businesses with a rental-based model).
revenue_surprise
number
optional
The difference between the actual and estimated revenue.
revenue_surprise_percent
number
optional
The percentage difference between the actual and estimated revenue.
ticker
string
optional
The stock symbol of the company reporting earnings.
time
string
optional
The time (formatted as 24-hour HH:MM:SS UTC) when the earnings are scheduled or were reported.
status
enum (OK)
The status of this request's response.