> 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"
}
}
```