---
title: "Get Forecast What If Run"
method: GET
path: "/tokenomics/v1/forecast-what-if-runs/{run_id}"
tags: ["tokenomics", "forecast_config"]
---

# Get Forecast What If Run

`GET /tokenomics/v1/forecast-what-if-runs/{run_id}`

## Request

- Base URL: `https://api.galileo.ai`
- URL: `https://api.galileo.ai/tokenomics/v1/forecast-what-if-runs/{run_id}`
- Auth: one of:
  - API key in header `Splunk-AO-API-Key`
  - API key in header `Galileo-API-Key`
  - OAuth 2
    - Password
    - Token URL: `https://api.galileo.ai/login`
  - HTTP basic
- TypeScript: <https://skmtc.dev/galileo/apis/galileo-api-server/docs/tokenomics/v1/forecast-what-if-runs/:run_id/get.ts> (a function with typed inputs; its response is checked against the schema)

A run's status and, once done, its ratio of remaining to view spend per fiscal week.

## Path parameters

- `run_id` string, uuid4, required

## Response `200`

Successful Response

- ForecastWhatIfRunResponse: ``ratio`` is set only when ``status`` is ``done``, and ``reason`` only when it is ``failed``.
  - `status` 'queued' | 'running' | 'done' | 'failed', required
  - `ratio` ForecastWhatIfRatio[], nullable
    - `fiscal_period_id` string, required
    - `mean` number, required
    - `lower` number, required
    - `upper` number, required
  - `reason` 'insufficient_history' | 'fetch_failed' | 'model_failed' | 'timeout', nullable

## Other responses

- `422`: Validation Error

## Changes

> 42 revisions in range; 2 not diffed.

- **2026-11-11** `8f6052380bd8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/galileo/apis/galileo-api-server/changes/tokenomics/v1/forecast-what-if-runs/:run_id/get.md)

---

[API](https://skmtc.dev/galileo/apis/galileo-api-server.md) - [All operations](https://skmtc.dev/galileo/apis/galileo-api-server/llms.txt) - [OpenAPI document](https://skmtc.dev/galileo/apis/galileo-api-server/revisions/8f6052380bd8?raw)