---
title: "Returns guidance data"
method: GET
path: "/api/v2.1/calendar/guidance"
tags: ["guidance"]
---

# Returns guidance data

`GET /api/v2.1/calendar/guidance`

Returns company guidance data including forward-looking earnings and revenue projections provided by company management. Includes EPS guidance ranges (min/max), revenue guidance ranges, and comparisons to prior guidance. Guidance is crucial for understanding management's expectations for future performance.

## Query parameters

- `page` integer
- `pagesize` integer
- `parameters[date]` string, YYYY-MM-DD
- `parameters[date_from]` string, YYYY-MM-DD
- `parameters[date_to]` string, YYYY-MM-DD
- `parameters[importance]` 0 | 1 | 2 | 3 | 4 | 5
- `parameters[is_primary]` 'Y' | 'N' | 'All'
- `parameters[tickers]` string, csv
- `parameters[updated]` integer

## Headers

- `accept` 'application/json', required

## Response `200`

success

- ApiGuidanceResponse — API response containing an array of guidance records
  - `guidance` GitlabBenzingaIoBenzingaBzgoPkgModelsCalendarApiGuidance[]
    - `confirmed` boolean
    - `currency` string
    - `cusip` string
    - `date` string
    - `eps_guidance_est` string
    - `eps_guidance_max` string
    - `eps_guidance_min` string
    - `eps_guidance_prior_max` string
    - `eps_guidance_prior_min` string
    - `eps_type` string
    - `exchange` string
    - `id` string
    - `importance` integer
    - `is_primary` string
    - `name` string
    - `notes` string
    - `period` string
    - `period_year` integer
    - `prelim` string
    - `revenue_guidance_est` string
    - `revenue_guidance_max` string
    - `revenue_guidance_min` string
    - `revenue_guidance_prior_max` string
    - `revenue_guidance_prior_min` string
    - `revenue_type` string
    - `ticker` string
    - `time` string — Time of guidance announcement (EST)
    - `updated` integer

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.dev/benzinga/apis/data-api-proxy.md) · [All operations](https://skmtc.dev/benzinga/apis/data-api-proxy/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/benzinga/data-api-proxy/revisions/ea334a9e2e05/schema)