---
title: "Retrieve Metrics For Step"
method: GET
path: "/v1/steps/{step_id}/metrics"
tags: ["steps"]
---

# Retrieve Metrics For Step

`GET /v1/steps/{step_id}/metrics`

Get step metrics by step ID.

## Path parameters

- `step_id` string, required

## Response `200`

Successful Response

- StepMetrics
  - `id` string, required — The id of the step this metric belongs to (matches steps.id).
  - `provider_id` string, nullable — The unique identifier of the provider.
  - `run_id` string, nullable — The unique identifier of the run.
  - `agent_id` string, nullable — The unique identifier of the agent.
  - `step_start_ns` integer, nullable — The timestamp of the start of the step in nanoseconds.
  - `llm_request_start_ns` integer, nullable — The timestamp of the start of the llm request in nanoseconds.
  - `llm_request_ns` integer, nullable — Time spent on LLM requests in nanoseconds.
  - `tool_execution_ns` integer, nullable — Time spent on tool execution in nanoseconds.
  - `step_ns` integer, nullable — Total time for the step in nanoseconds.
  - `base_template_id` string, nullable — The base template ID that the step belongs to (cloud only).
  - `template_id` string, nullable — The template ID that the step belongs to (cloud only).
  - `project_id` string, nullable — The project that the step belongs to (cloud only).

## Other responses

- `422` — Validation Error

## Changes

- **2025-09-29** `ac8e1eb68404` — 1 warning, 1 info
  - removed the optional property `job_id` from the response with the `200` status
  - added the optional property `run_id` to the response with the `200` status

[Change history](https://skmtc.dev/yu-code666/apis/letta-api/changes/v1/steps/:step_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)