> ## Documentation Index
> Fetch the complete documentation index at: https://hc.pillargtm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Forecast API

> Forecast overrides, snapshots, and pipeline cohort analysis

# Forecast API

## Forecast Data

```
GET /api/forecast
POST /api/forecast
```

### GET

Returns the current forecast view including:

* Per-rep forecast summaries with quota attainment
* 5-band probability-weighted totals (Won, Commit, Probable, Upside, Projection)
* Low/Medium/High/Moonshot bands
* Historical snapshot comparisons
* Pipeline cohort vintage analysis

### POST

Creates or updates forecast overrides for specific opportunities in a period.

## Forecast Override

Each forecast override captures:

| Field                | Description                                  |
| -------------------- | -------------------------------------------- |
| Opportunity          | Target deal                                  |
| Period               | Forecast period (e.g., "2025-Q2")            |
| Category             | Won, Commit, Probable, Upside, or Projection |
| Amount               | Forecast amount                              |
| Weighted Amount      | Auto-calculated probability-weighted amount  |
| Next Step            | Dated deal narrative                         |
| Executive Engagement | Whether exec sponsor is engaged              |
| Confidence Rationale | Why this category was assigned               |
| Product Mix          | Products included in the deal                |

## Probability Weights

Each forecast category carries a configurable probability weight used for weighted pipeline calculations. Weights decrease from Won (highest certainty) through Projection (lowest certainty).

> Default probability weights per forecast category are available in the PILLAR Implementation Guide provided to active customers.