---
title: "List run steps"
method: GET
path: "/api/v1/runs/{run_id}/steps"
tags: ["runs"]
---

# List run steps

`GET /api/v1/runs/{run_id}/steps`

Paginated execution trace steps for a run with step_type, tool_name, tokens, and latency.

## Path parameters

- `run_id` string, required — Identifier of the run whose steps to list.

## Query parameters

- `limit` integer — Page size
- `offset` integer — Pagination offset

## Response `200`

Successful Response

- RunStepListResponse — Paginated execution step list for a run.
  - `items` RunStepItem[], required — Step list items.
    - `id` string, required — Durable step identifier.
    - `step_index` integer, required — Step position within the run.
    - `step_type` string, required — Step type (e.g. tool_call, reasoning).
    - `tool_name` string, nullable — Tool name when applicable.
    - `tokens_in` integer, nullable — Input token count.
    - `tokens_out` integer, nullable — Output token count.
    - `latency_ms` integer, nullable — Step latency in milliseconds.
    - `created_at` string, required — ISO-8601 creation timestamp.
  - `total` integer, required — Total steps in run.
  - `offset` integer, required — Current pagination offset.
  - `limit` integer, required — Current page size.
  - `has_more` boolean, required — Whether more steps exist beyond this page.

## Other responses

- `401` — Authentication is required or the provided token is invalid.
- `404` — Run not found.
- `422` — Validation Error
- `503` — Run services are unavailable because server startup is incomplete.

---

[API](https://skmtc.net/qredence/apis/fleet-rlm.md) · [All operations](https://skmtc.net/qredence/apis/fleet-rlm/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qredence/fleet-rlm/revisions/62e8c152aa18/schema)