Get started

Workload counterfactual cost

Source

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.

text
GET /api/v1/org/workloads/{slug}/counterfactual
text
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"
  }
}