---
title: "Get Run Llm Costs"
method: GET
path: "/v1/runs/{run_id}/llm-costs"
tags: ["runs"]
---

# Get Run Llm Costs

`GET /v1/runs/{run_id}/llm-costs`

## Request

- Base URL: `https://api.cyberdesk.io`
- URL: `https://api.cyberdesk.io/v1/runs/{run_id}/llm-costs`
- Auth: HTTP bearer

Get the LLM provider cost breakdown for a run, grouped by agent role and model.

Requires the `llm_cost_visibility` feature flag. `cost_usd` is null for rows
whose model has no pricing yet.

## Path parameters

- `run_id` string, uuid, required

## Response `200`

Successful Response

- RunLlmCostsResponse
  - `run_id` string, uuid, required
  - `total_cost_usd` number, nullable
  - `has_unpriced` boolean, required
  - `rows` RunLlmCostRow[], required
    - `role` string, required
    - `billing_platform` string, required
    - `model` string, required
    - `endpoint_type` string, required
    - `call_count` integer, required
    - `input_tokens` integer, required
    - `uncached_input_tokens` integer, required
    - `cache_read_tokens` integer, required
    - `cache_write_5m_tokens` integer, required
    - `cache_write_1h_tokens` integer, required
    - `output_tokens` integer, required
    - `reasoning_tokens` integer, required
    - `cost_usd` number, nullable
    - `source` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-03** `5579352ae05e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud/changes/v1/runs/:run_id/llm-costs/get.md)

---

[API](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud.md) - [All operations](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud/revisions/5579352ae05e?raw)