---
title: "Get Billing Routed Savings"
method: GET
path: "/billing/usage/routed-savings"
tags: ["billing"]
---

# Get Billing Routed Savings

`GET /billing/usage/routed-savings`

Routed-savings rollup per router project plus an overall total.

## Query parameters

- `start_date` string, nullable — Range start (ISO date or datetime, UTC); ignored when full_history=true
- `end_date` string, nullable — Range end (ISO date or datetime, UTC); with full_history, caps the window
- `full_history` boolean — If true, span from the team's first request through end (or now); ignores start_date

## Response `200`

Successful Response

- RoutedSavingsResponse — Routed-savings report: overall rollup plus a per-project breakdown.
  - `overall` RoutedSavingsItem, required — Routed-savings rollup for one project (or the overall total). Costs are the router's expected-cost basis recorded per inference, where ``savings_usd`` is the benefit of the chosen model relative to the most expensive candidate the router considered — not a billed-dollar figure.
    - `project_id` string, nullable — Router project UUID; None for the overall rollup row
    - `routed_request_count` integer
    - `fallback_count` integer
    - `expected_cost_usd` number
    - `most_expensive_cost_usd` number
    - `savings_usd` number
    - `savings_ratio` number — savings_usd / most_expensive_cost_usd, 0 when no baseline
  - `per_project` RoutedSavingsItem[], required
    - `project_id` string, nullable — Router project UUID; None for the overall rollup row
    - `routed_request_count` integer
    - `fallback_count` integer
    - `expected_cost_usd` number
    - `most_expensive_cost_usd` number
    - `savings_usd` number
    - `savings_ratio` number — savings_usd / most_expensive_cost_usd, 0 when no baseline

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/pioneer/apis/brain-api.md) · [All operations](https://skmtc.net/pioneer/apis/brain-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pioneer/brain-api/versions/31dfe831e079/schema)