---
title: "GET /benzinga/v1/earnings"
method: GET
path: "/benzinga/v1/earnings"
tags: ["benzinga"]
---

# GET /benzinga/v1/earnings

`GET /benzinga/v1/earnings`

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.

## Query parameters

- `date` string
- `date.any_of` string
- `date.gt` string
- `date.gte` string
- `date.lt` string
- `date.lte` string
- `ticker` string
- `ticker.any_of` string
- `ticker.gt` string
- `ticker.gte` string
- `ticker.lt` string
- `ticker.lte` string
- `importance` integer
- `importance.any_of` string
- `importance.gt` integer
- `importance.gte` integer
- `importance.lt` integer
- `importance.lte` integer
- `last_updated` string
- `last_updated.any_of` string
- `last_updated.gt` string
- `last_updated.gte` string
- `last_updated.lt` string
- `last_updated.lte` string
- `date_status` string
- `date_status.any_of` string
- `date_status.gt` string
- `date_status.gte` string
- `date_status.lt` string
- `date_status.lte` string
- `eps_surprise_percent` number, double
- `eps_surprise_percent.any_of` string
- `eps_surprise_percent.gt` number, double
- `eps_surprise_percent.gte` number, double
- `eps_surprise_percent.lt` number, double
- `eps_surprise_percent.lte` number, double
- `revenue_surprise_percent` number, double
- `revenue_surprise_percent.any_of` string
- `revenue_surprise_percent.gt` number, double
- `revenue_surprise_percent.gte` number, double
- `revenue_surprise_percent.lt` number, double
- `revenue_surprise_percent.lte` number, double
- `fiscal_year` integer
- `fiscal_year.any_of` string
- `fiscal_year.gt` integer
- `fiscal_year.gte` integer
- `fiscal_year.lt` integer
- `fiscal_year.lte` integer
- `fiscal_period` string
- `fiscal_period.any_of` string
- `fiscal_period.gt` string
- `fiscal_period.gte` string
- `fiscal_period.lt` string
- `fiscal_period.lte` string
- `limit` integer
- `sort` string

## Response `200`

A list of results.

- object
  - `next_url` string — If present, this value can be used to fetch the next page.
  - `request_id` string, required — A request id assigned by the server.
  - `results` object[], required — The results for this request.
    - `actual_eps` number, double — The actual earnings per share (EPS) reported by the company for the given period.
    - `actual_revenue` number, double — The actual revenue reported by the company for the given fiscal period.
    - `benzinga_id` string — The identifier used by Benzinga for this record.
    - `company_name` string — The name of the company releasing earnings.
    - `currency` string — The ISO 4217 currency code indicating the denomination in which the figures are reported.
    - `date` string — The calendar date (formatted as YYYY-MM-DD) when the earnings are scheduled or were reported.
    - `date_status` string — Indicates whether the date of the earnings report has been confirmed. Possible values include: projected, confirmed.
    - `eps_method` string — 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, double — The difference between the actual and estimated EPS.
    - `eps_surprise_percent` number, double — The percentage difference between the actual and estimated EPS.
    - `estimated_eps` number, double — The analyst consensus estimate for earnings per share (EPS) for the given period.
    - `estimated_revenue` number, double — The analyst consensus estimate for the company's revenue in the given period.
    - `fiscal_period` string — The fiscal period for which the earnings are reported. Examples include: Q1, Q2, H1, FY.
    - `fiscal_year` integer — The fiscal year in which the earnings period falls.
    - `importance` integer — A subjective indicator of the importance of the event, on a scale from 0 (lowest) to 5 (highest).
    - `last_updated` string, date-time — The timestamp (formatted as an ISO 8601 timestamp) when the record was last updated in the system.
    - `notes` string — Additional context, commentary, or clarifying notes related to the earnings event.
    - `previous_eps` number, double — The company's reported earnings per share (EPS) for the previous comparable period.
    - `previous_revenue` number, double — The company's revenue for the previous comparable fiscal period.
    - `revenue_method` string — 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, double — The difference between the actual and estimated revenue.
    - `revenue_surprise_percent` number, double — The percentage difference between the actual and estimated revenue.
    - `ticker` string — The stock symbol of the company reporting earnings.
    - `time` string — The time (formatted as 24-hour HH:MM:SS EST) when the earnings are scheduled or were reported.
  - `status` 'OK', required — The status of this request's response.

## Other responses

- `400` — An error message.

---

[API](https://skmtc.net/massive/apis/polygon-api.md) · [All operations](https://skmtc.net/massive/apis/polygon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/massive/polygon-api/revisions/ad6f143e43aa/schema)