Skip to main content
GET
Get forward guidance

Overview

The KPI Guidance API returns structured forward guidance extracted from earnings releases. Guidance is delivered as ranges (low/high), point estimates, or directional signals. Examples: operating margin guidance of 6-8%, EPS guidance of 1.001.00-1.50, capacity growth of flat YoY, fuel price assumptions, FFO per share outlook.

Coverage

Available Tickers

You can fetch a list of available tickers with a GET request to: https://api.financialdatasets.ai/kpi/guidance/tickers/

Getting Started

  1. Add your API key to the header of the request as X-API-KEY.
  2. Add the required query param ticker.
  3. Execute the API request.

Filtering the Data

Example

KPI Guidance

Example Response

Response Fields

Notes

  • Guidance periods are forward-looking (e.g., Q2 2026 guidance reported in a Q1 2026 filing).
  • The source_url links directly to the source document with text highlighting when available.

Authorizations

X-API-KEY
string
header
required

API key for authentication.

Query Parameters

ticker
string
required

The ticker symbol.

metric_name
string

Filter to a specific metric.

period
enum<string>
default:quarterly

Filter by period type: quarterly or annual.

Available options:
quarterly,
annual
report_period_gte
string<date>

Only return guidance on or after this date (YYYY-MM-DD).

report_period_lte
string<date>

Only return guidance on or before this date (YYYY-MM-DD).

limit
integer
default:4

Number of periods to return.

Required range: x <= 50

Response

Guidance response

kpi_guidance
object[]