---
title: "Get forward guidance"
method: GET
path: "/kpi/guidance"
tags: ["KPIs"]
---

# Get forward guidance

`GET /kpi/guidance`

Get structured forward guidance from earnings releases. Returns ranges, point estimates, and directional signals.

## Query parameters

- `ticker` string, required
- `metric_name` string
- `period` 'quarterly' | 'annual'
- `report_period_gte` string, date
- `report_period_lte` string, date
- `limit` integer

## Response `200`

Guidance response

- KPIGuidanceResponse
  - `kpi_guidance` KPIGuidanceItem[]
    - `ticker` string, required
    - `metric_name` string, required
    - `value` number, nullable
    - `unit` string
    - `period` string, required
    - `period_type` 'quarterly' | 'annual', required
    - `segment` string, nullable
    - `low` number, nullable — Low end of guidance range.
    - `high` number, nullable — High end of guidance range.
    - `point_estimate` number, nullable — Single-point guidance when no range is given.
    - `prior_value` number, nullable — Prior guidance value for revisions.
    - `raw_text` string, nullable — Original guidance text from the filing.
    - `change_direction` string, nullable — Direction: raised, lowered, maintained, initiated, withdrawn.
    - `source_text` string, nullable
    - `source_url` string, uri, nullable

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Pro subscription required

---

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