---
title: "Token usage and cost for a single RFT run"
method: GET
path: "/api/v1/billing/runs/{run_id}/usage"
tags: ["Billing"]
---

# Token usage and cost for a single RFT run

`GET /api/v1/billing/runs/{run_id}/usage`

Return the running token + cost totals for one RFT run.

Mirrors the per-row training data shown on the billing page (Training
tokens, Inference input/output tokens, price per million tokens, and
total cost) so an agent can poll this endpoint to monitor a live run.

## Path parameters

- `run_id` string, required

## Response `200`

Successful Response

- RunUsageResponse — Per-run usage totals — drives `prime train usage <run_id>`.
  - `run_id` string, required
  - `run_name` string, nullable
  - `base_model` string, nullable
  - `status` string, nullable
  - `training` RunUsageBreakdown, required — Token + cost totals for a single usage type within a run.
    - `tokens` integer — Total tokens recorded for this usage type
    - `input_tokens` integer — Total input tokens (only populated for INFERENCE)
    - `output_tokens` integer — Total output tokens (only populated for INFERENCE)
    - `cost_usd` number — Total cost charged for this usage type
  - `inference` RunUsageBreakdown, required — Token + cost totals for a single usage type within a run.
    - `tokens` integer — Total tokens recorded for this usage type
    - `input_tokens` integer — Total input tokens (only populated for INFERENCE)
    - `output_tokens` integer — Total output tokens (only populated for INFERENCE)
    - `cost_usd` number — Total cost charged for this usage type
  - `total_tokens` integer, required
  - `total_cost_usd` number, required
  - `pricing` RunPricing, required — Snapshotted per-million-token pricing used to bill the run.
    - `training_per_mtok` number, nullable
    - `inference_input_per_mtok` number, nullable
    - `inference_output_per_mtok` number, nullable
  - `record_count` integer

## Other responses

- `401` — Authorization failed
- `422` — Invalid request data

---

[API](https://skmtc.net/primeintellect/apis/pi-api.md) · [All operations](https://skmtc.net/primeintellect/apis/pi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/primeintellect/pi-api/revisions/126e47974033/schema)