---
title: "Retrieve Run Usage"
method: GET
path: "/v1/runs/{run_id}/usage"
tags: ["runs"]
---

# Retrieve Run Usage

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

Get usage statistics for a run.

## Path parameters

- `run_id` string, required

## Response `200`

Successful Response

- UsageStatistics
  - `completion_tokens` integer
  - `prompt_tokens` integer
  - `total_tokens` integer
  - `prompt_tokens_details` UsageStatisticsPromptTokenDetails
    - `cached_tokens` integer
  - `completion_tokens_details` UsageStatisticsCompletionTokenDetails
    - `reasoning_tokens` integer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/yu-code666/apis/letta-api.md) · [All operations](https://skmtc.dev/yu-code666/apis/letta-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/yu-code666/letta-api/revisions/6cec99480c13/schema)