---
title: "List Llm Costs"
method: GET
path: "/v1/usage/llm-costs"
tags: ["usage"]
---

# List Llm Costs

`GET /v1/usage/llm-costs`

## Request

- Base URL: `https://api.cyberdesk.io`
- URL: `https://api.cyberdesk.io/v1/usage/llm-costs`
- Auth: HTTP bearer

List per-run LLM provider cost totals for runs created in the given period.

Requires the `llm_cost_visibility` feature flag. Only runs with recorded LLM
usage are returned, newest first.

## Query parameters

- `from_date` string, date-time, nullable: Start of period (inclusive, ISO format)
- `to_date` string, date-time, nullable: End of period (exclusive, ISO format)
- `skip` integer
- `limit` integer

## Response `200`

Successful Response

- PaginatedResponseRunLlmCostTotalResponse
  - `items` RunLlmCostTotalResponse[], required
    - `run_id` string, uuid, required
    - `workflow_id` string, uuid, required
    - `created_at` string, date-time, required
    - `total_cost_usd` number, nullable
    - `has_unpriced` boolean, required
  - `total` integer, required
  - `skip` integer, required
  - `limit` integer, 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/usage/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)