---
title: "Get Predictions"
method: GET
path: "/metrics/predictions"
---

# Get Predictions

`GET /metrics/predictions`

Evaluate all predictive forecasts and return active alerts.

Checks three forecast dimensions:

- **Budget exhaustion**: At current spend velocity, when will the
  budget cap be reached?
- **Completion rate decline**: Is the task completion rate trending
  downward, indicating the run will take longer than expected?
- **Run duration overrun**: Based on current throughput, will the run
  exceed the configured time window?

Use ``budget_cap`` to enable the budget forecast. The run duration
forecast requires at least one completed task.

Returns a list of ``alerts`` ordered by severity (critical first).
Each alert has: ``kind``, ``severity``, ``message``,
``minutes_until_impact``, ``confidence``.

## Query parameters

- `budget_cap` number — Budget ceiling in USD (0 = skip budget forecast)
- `window_hours` number — Configured run window in hours (default 4)

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/sipyourdrink-ltd/apis/bernstein-task-server.md) · [All operations](https://skmtc.net/sipyourdrink-ltd/apis/bernstein-task-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sipyourdrink-ltd/bernstein-task-server/revisions/86f514b4e920/schema)
