---
title: "Retrieve Metrics For Run"
method: GET
path: "/v1/runs/{run_id}/metrics"
tags: ["runs"]
---

# Retrieve Metrics For Run

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

Get run metrics by run ID.

## Path parameters

- `run_id` string, required

## Response `200`

Successful Response

- RunMetrics
  - `id` string, required — The id of the run this metric belongs to (matches runs.id).
  - `agent_id` string, nullable — The unique identifier of the agent.
  - `project_id` string, nullable — The project that the run belongs to (cloud only).
  - `run_start_ns` integer, nullable — The timestamp of the start of the run in nanoseconds.
  - `run_ns` integer, nullable — Total time for the run in nanoseconds.
  - `num_steps` integer, nullable — The number of steps in the run.
  - `template_id` string, nullable — The template ID that the run belongs to (cloud only).
  - `base_template_id` string, nullable — The base template ID that the run belongs to (cloud only).

## Other responses

- `422` — Validation Error

## Changes

- **2025-10-08** `a304c2da8bc0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/yu-code666/apis/letta-api/changes/v1/runs/:run_id/metrics/get.md)

---

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