---
title: "Forecast in the transitional window shape"
method: GET
path: "/v1/forecast/windows"
---

# Forecast in the transitional window shape

`GET /v1/forecast/windows`

## Request

- Base URL: `https://docs.greatwait.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.greatwait.dev/v1/forecast/windows`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer and API key in header `Greatwait-Environment` and API key in header `Greatwait-Project`

The same forecast in the window shape the legacy scheduler's autoscaler already parses, published under a dated version so a consumer can pin it. It exists for one migration and is expected to be withdrawn once that migration completes; `forecast.read` is the shape this product publishes. `byTenant` is the customer partition-key breakdown under its legacy name, and `count` is always the bucket total rather than the named subtotal.

## Query parameters

- `breakdown` 'none' | 'partitionKey'
- `bucketSeconds` integer
- `from` string
- `to` string

## Response `200`

Forecast in the transitional window shape

- object
  - `bucketSeconds` integer, required
  - `buckets` object[], required
    - `byTenant` object, required
    - `count` integer, required
    - `nextFireCount` integer, required
    - `otherCount` integer, required
    - `start` string, required
  - `freshness` union, required
    - object
      - `kind` 'authoritative', required
    - object
      - `asOf` string, required
      - `kind` 'projected', required
      - `lagSeconds` integer, required
  - `version` '2026-08-09', required

## Other responses

- `400`: Problem document. Possible codes at this status: invalid_request.
- `401`: Problem document. Possible codes at this status: authentication_required, credential_expired, credential_revoked.
- `403`: Problem document. Possible codes at this status: scope_missing.
- `409`: Problem document. Possible codes at this status: project_archived.
- `429`: Problem document. Possible codes at this status: rate_limited.
- `503`: Problem document. Possible codes at this status: capability_not_configured, service_unavailable.

---

[API](https://skmtc.dev/greatwait/apis/greatwait-v1.md) · [All operations](https://skmtc.dev/greatwait/apis/greatwait-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/greatwait/apis/greatwait-v1/revisions/6855bce23e72?raw)