FIfinancialdatasets
KPIs

Get forward guidance

Changed on

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

get/kpi/guidance

Request

  • Base URL
    https://api.financialdatasets.ai
  • Auth
    API key in header X-API-KEY

Query parameters

tickerstring required

The ticker symbol.

metric_namestring

Filter to a specific metric.

period'quarterly' | 'annual'

Filter by period type: quarterly or annual.

report_period_gtestring date

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

report_period_ltestring date

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

limitinteger

Number of periods to return. This is the total across all pages, not a page size: each page holds up to 10 records, linked by next_page_url.

cursorstring

Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.

Response

Guidance response

next_page_urlstring

Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.

Example response

{
  "kpi_guidance": [
    {
      "ticker": "DAL",
      "metric_name": "Operating Margin",
      "unit": "%",
      "period": "Q2 2026",
      "low": 6,
      "high": 8,
      "change_direction": "initiated"
    }
  ]
}

Changes

  • 5872e134b56cRevision changes
    • info

      added the new optional query request parameter cursor

    • info

      added the optional property to the response with the status