---
title: "Get Savings"
method: GET
path: "/llm/savings"
tags: ["llm"]
---

# Get Savings

`GET /llm/savings`

## Request

- Base URL: `https://api.os3robotics.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.os3robotics.com/llm/savings`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Query parameters

- `workspace_id` string, uuid, nullable
- `start` string, date, nullable
- `end` string, date, nullable

## Response `200`

Successful Response

- Savings
  - `start` string, date, required
  - `end` string, date, required
  - `workspace_id` string, uuid, nullable, required
  - `price_snapshot` string, date, required
  - `min_trials` integer, required
  - `baseline_usd` string, required
  - `savings_usd` string, required
  - `tasks` TaskSavings[], required
    - `task_id` string, uuid, required
    - `label` string, required
    - `baseline` Traffic, required
      - `traces` integer
      - `cost_usd` string
      - `uncosted` integer
      - `vendor` string, nullable
      - `upstream_id` string, uuid, nullable
    - `eval_set` EvalSetView, required
      - `id` string, uuid, required
      - `version` integer, required
      - `holdout` integer, required
      - `dev` integer, required
      - `manifest_sha256` string, required
      - `frozen_at` string, date-time, required
      - `validated` boolean, required
      - `problems` string[], required
    - `optimised` Optimised, required
      - `eval_id` string, uuid, required
      - `candidate_ref` string, required
      - `model` string, required
      - `system` string, nullable, required
      - `gpu` string, nullable, required
      - `incumbent_model` string, required
      - `n` integer, required
      - `margin_pts` number, required
      - `margin_ci_lower_pts` number, required
      - `passed` boolean, required
      - `judge_calibration` object, nullable, required
      - `traffic` Traffic, required
        - `traces` integer
        - `cost_usd` string
        - `uncosted` integer
        - `vendor` string, nullable
        - `upstream_id` string, uuid, nullable
      - `incumbent_usd_per_request` string, nullable, required
      - `candidate_usd_per_request` string, nullable, required
    - `savings_usd` string, nullable, required
    - `counted` boolean, required
    - `contract` ContractRef, required
      - `id` string, uuid, required
      - `version` integer, required
    - `routes` RouteView[], required
      - `id` string, uuid, required
      - `release_decision_id` string, uuid, required
      - `state` string, required
      - `percent` integer, required
      - `model` string, required
      - `incumbent_model` string, required
      - `incumbent_usd_per_request` string, nullable, required
    - `realised` Realised, required
      - `requests` object, required
      - `failed` integer, required
      - `repeated` integer, required
      - `counterfactual_usd` string, nullable, required
      - `costs` object, required
      - `cost_usd` string, nullable, required
      - `known_cost_usd` string, required
      - `net_savings_usd` string, nullable, required
      - `unknown` string[], required
    - `contracts` ContractRealised[], required
      - `contract` ContractRef, required
        - `id` string, uuid, required
        - `version` integer, required
      - `realised` Realised, required
        - `requests` object, required
        - `failed` integer, required
        - `repeated` integer, required
        - `counterfactual_usd` string, nullable, required
        - `costs` object, required
        - `cost_usd` string, nullable, required
        - `known_cost_usd` string, required
        - `net_savings_usd` string, nullable, required
        - `unknown` string[], required
    - `break_even` BreakEven[], required
      - `eval_id` string, uuid, required
      - `gpu` string, required
      - `capacity_usd_per_month` string, nullable, required
      - `incumbent_usd_per_request` string, nullable, required
      - `serving_usd_per_request` string, nullable, required
      - `requests_per_day` integer, nullable, required
      - `current_requests_per_day` string, required
  - `realised` RealisedReport, required
    - `start` string, date, required
    - `end` string, date, nullable, required
    - `total` Realised, required
      - `requests` object, required
      - `failed` integer, required
      - `repeated` integer, required
      - `counterfactual_usd` string, nullable, required
      - `costs` object, required
      - `cost_usd` string, nullable, required
      - `known_cost_usd` string, required
      - `net_savings_usd` string, nullable, required
      - `unknown` string[], required
    - `unattributed` Realised, required
      - `requests` object, required
      - `failed` integer, required
      - `repeated` integer, required
      - `counterfactual_usd` string, nullable, required
      - `costs` object, required
      - `cost_usd` string, nullable, required
      - `known_cost_usd` string, required
      - `net_savings_usd` string, nullable, required
      - `unknown` string[], required
    - `reconciliation` Reconciled[], required
      - `meter` string, required
      - `vendor` string, required
      - `model` string, required
      - `key_owner` string, required
      - `ledger` string, required
      - `report` string, required
    - `reconciled` boolean, required
    - `missing` MissingCost[], required
      - `kind` 'no_price' | 'no_usage' | 'plan_price' | 'outside_route' | 'route_baseline' | 'shadow' | 'gpu_price' | 'statement', required
      - `why` string, required
      - `lines` string[], required
      - `vendor` string, nullable
      - `model` string, nullable
      - `key_owner` string, nullable
      - `upstream_id` string, uuid, nullable
      - `upstream_name` string, nullable
      - `price_editable` boolean
      - `evaluation` boolean
      - `requests` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/os3robotics/apis/os3-api.md) - [All operations](https://skmtc.dev/os3robotics/apis/os3-api/llms.txt) - [OpenAPI document](https://skmtc.dev/os3robotics/apis/os3-api/revisions/af32cd4f14bb?raw)