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

# GET /benzinga/v1/guidance

`GET /benzinga/v1/guidance`

A comprehensive database of financial guidance and earnings estimates for various companies, capturing key metrics related to earnings per share (EPS) and revenue projections across different fiscal periods.

## 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
- `positioning` string
- `positioning.any_of` string
- `positioning.gt` string
- `positioning.gte` string
- `positioning.lt` string
- `positioning.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
- `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.
    - `benzinga_id` string — A unique identifier assigned by Benzinga to the guidance record.
    - `company_name` string — The name of the company issuing guidance.
    - `currency` string — The ISO 4217 code representing the currency in which the company issued its guidance figures.
    - `date` string — The calendar date (formatted as YYYY-MM-DD) when the guidance was issued.
    - `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).
    - `estimated_eps_guidance` number, double — The analyst consensus EPS estimate at the time the company issued its guidance. This can sit above, below, or in line with the company's issued range.
    - `estimated_revenue_guidance` number, double — The analyst consensus revenue estimate at the time the company issued its guidance. This can sit above, below, or in line with the company's issued range.
    - `fiscal_period` string — The fiscal quarter to which the guidance applies, such as Q1, Q2, Q3, or Q4.
    - `fiscal_year` integer — The fiscal year corresponding to the period for which the guidance is issued.
    - `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.
    - `max_eps_guidance` number, double — The highest EPS value the company expects for the fiscal period if a range was provided.
    - `max_revenue_guidance` number, double — The highest revenue figure the company expects for the fiscal period if a range was provided.
    - `min_eps_guidance` number, double — The lowest EPS value the company expects for the fiscal period if a range was provided.
    - `min_revenue_guidance` number, double — The lowest revenue figure the company expects for the fiscal period if a range was provided.
    - `notes` string — Additional descriptive text or commentary provided about the guidance record.
    - `positioning` string — Indicates how a particular guidance value is presented relative to other figures disclosed by the company. Possible values are 'primary' (the emphasized figure) and 'secondary' (a supporting or alternate figure)
    - `previous_max_eps_guidance` number, double — The highest EPS value issued in a previous guidance record for the same fiscal period.
    - `previous_max_revenue_guidance` number, double — The highest revenue value issued in a previous guidance record for the same fiscal period.
    - `previous_min_eps_guidance` number, double — The lowest EPS value issued in a previous guidance record for the same fiscal period.
    - `previous_min_revenue_guidance` number, double — The lowest revenue value issued in a previous guidance record for the same fiscal period.
    - `release_type` string — Indicates whether the guidance was issued as part of a scheduled earnings release ('official') or as an unscheduled update ('preliminary').
    - `revenue_method` string — The methodology of the revenue figure. Possible values are gaap (standardized financials under Generally Accepted Accounting Principles) and adj (adjusted, non-GAAP).
    - `ticker` string — The stock symbol of the company issuing guidance.
    - `time` string — The time of day the guidance was announced, in HH:mm:ss format.
  - `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)