Financial Datasets

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

Changed on
get/financial-datasets/kpi/guidance

Request

Query parameters

tickerstring required

The ticker symbol.

metric_namestring

Filter to a specific metric.

periodstring

Filter by period type: quarterly or annual.

report_period_gtestring

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

report_period_ltestring

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

Successful response

Changes

    • breaking

      added the new required query request parameter ticker

    • info

      added the new optional query request parameter cursor

    • info

      added the new optional query request parameter limit

    • info

      added the new optional query request parameter metric_name

    • info

      added the new optional query request parameter period

    • info

      added the new optional query request parameter report_period_gte

    • info

      added the new optional query request parameter report_period_lte

    • info

      endpoint added