> Source: https://vitna.ai/docs/api/v1/engine/org-counterfactual
> Raw Markdown: https://vitna.ai/docs/api/v1/engine/org-counterfactual.md
> Corpus index: https://vitna.ai/llms.txt

# Workload counterfactual cost

Compute what a recorded usage window of one of your organisation's workloads would have cost at historical Witness list prices had it run on another SKU.

```
GET /api/v1/org/workloads/{slug}/counterfactual
```

```
Authorization: Bearer vitna_push_...
```

```bash
curl -H "authorization: Bearer vitna_push_..." \
  "https://vitna.ai/api/v1/org/workloads/deep-research/counterfactual?window=2026-08-01..2026-08-31&candidate=anthropic/claude-sonnet-4-6"
```

## Bounds and caveats

Accepts either a `platform` or `push` key. Requires `window` (`YYYY-MM-DD..YYYY-MM-DD`, or `from` and `to`) and `candidate` (SKU ID or slug in the same component class).

When a price moved inside the window and the recorded usage window carries no daily split, both `actual` and `would` are reported as exact `[minUsd, maxUsd]` bounds rather than point estimates, and `caveats` states every coverage boundary. No candidate requests are run and no unmeasured quality figure is claimed.

## Response shape

```json
{
  "orgId": "convexity",
  "workload": {
    "id": "convexity/deep-research",
    "slug": "deep-research",
    "name": "Deep research",
    "classId": "model",
    "unitLabel": "runs"
  },
  "candidate": {
    "id": "anthropic/claude-sonnet-4-6",
    "name": "Claude Sonnet 4.6",
    "classId": "model"
  },
  "requestedWindow": {
    "start": "2026-08-01",
    "end": "2026-08-31"
  },
  "counterfactual": {
    "ok": true,
    "servedUnits": 50000,
    "actual": { "minUsd": 420, "maxUsd": 420, "exact": true },
    "would": { "minUsd": 290, "maxUsd": 290, "exact": true },
    "candidateSkuId": "anthropic/claude-sonnet-4-6",
    "difference": { "minUsd": -130, "maxUsd": -130, "exact": true },
    "moves": 0,
    "caveats": []
  },
  "sentence": "50,000 units over 2026-08-01 to 2026-08-31 cost $420.00 at list, and $290.00 on anthropic/claude-sonnet-4-6: $130.00 less.",
  "meta": {
    "generatedAt": "2026-09-14T18:40:00.000Z"
  }
}
```
