---
title: "Get specific step"
method: GET
path: "/api/v1/executions/{id}/steps/{stepIndex}"
tags: ["Decision & Execution Replay"]
---

# Get specific step

`GET /api/v1/executions/{id}/steps/{stepIndex}`

## Request

- Base URL: `https://orchestrator.getaxonflow.com`
- URL: `https://orchestrator.getaxonflow.com/api/v1/executions/{id}/steps/{stepIndex}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/docs/api/v1/executions/:id/steps/:stepIndex/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a specific step by index.

## Path parameters

- `id` string, required
- `stepIndex` integer, required

## Response `200`

Step details

- ExecutionSnapshot
  - `request_id` string
  - `step_index` integer
  - `step_name` string
  - `status` 'pending' | 'running' | 'completed' | 'failed' | 'paused'
  - `started_at` string, date-time
  - `completed_at` string, date-time
  - `duration_ms` integer
  - `input` object
  - `output` object
  - `provider` string
  - `model` string
  - `tokens_in` integer
  - `tokens_out` integer
  - `cost_usd` number, double
  - `policies_checked` string[]
  - `policies_triggered` PolicyEvent[]
    - `policy_id` string
    - `policy_name` string
    - `action` 'block' | 'warn' | 'require_approval'
    - `matched` string
    - `resolution` string
  - `error_message` string
  - `retry_count` integer
  - `approval_required` boolean: True when this step gated on human approval. The pair `approved_at` + `approved_by` records when and by whom the approval was granted (or shows null on rejection).
  - `approved_at` string, date-time: When the approval-required gate was resolved. Pair with `approved_by` to compute approval latency at the step level.
  - `approved_by` string: User email of the approver. Empty when `approval_required` is false or the gate was auto-resolved.

## Other responses

- `404`: Step not found

---

[API](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api.md) - [All operations](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getaxonflow/apis/axonflow-orchestrator-api/revisions/f408ef3ec9dd?raw)