---
title: "Codex Session Savings"
method: GET
path: "/v1/codex/session-savings/{session_id}"
tags: ["openai-compat"]
---

# Codex Session Savings

`GET /v1/codex/session-savings/{session_id}`

Return cumulative routing savings for one Codex session.

Args:
    session_id: Codex session id (the request ``prompt_cache_key``).
    auth: Authenticated request context; the billing team it resolves is
        applied as the read scope so sessions are not cross-team readable.

Returns:
    Cumulative savings for the session, or a ``found=False`` payload when
    nothing has accumulated.

## Path parameters

- `session_id` string, required

## Response `200`

Successful Response

- CodexSessionSavingsResponse — Cumulative routed-vs-frontier savings for one Codex session. Attributes: found: Whether any savings have been accumulated for the session. savings_usd: Cumulative dollars saved this session vs the frontier reference. ``0.0`` when nothing has accumulated yet. baseline_model: The frontier reference the savings are measured against, or ``None`` when no turn has been recorded.
  - `found` boolean, required — Whether any savings have accumulated for the session.
  - `savings_usd` number — Cumulative dollars saved this session vs the frontier.
  - `baseline_model` string, nullable — Frontier reference model the savings are measured against.

## 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)