---
title: "List Aperture Dataset Trajectory Steps"
method: GET
path: "/api/v1/aperture/dataset-trajectories/steps"
tags: ["aperture"]
---

# List Aperture Dataset Trajectory Steps

`GET /api/v1/aperture/dataset-trajectories/steps`

## Query parameters

- `dataset_name` string, required
- `trajectory_id` string, required
- `split` string
- `step_idx` integer
- `batch_size` integer
- `detail` 'summary' | 'details' | 'full'
- `live` boolean
- `dataset_source` 'default'

## Response `200`

Successful Response

- ApertureStepsWindowResponse — Display-indexed steps around the requested step, with the trajectory's rendered step count.
  - `steps` object, required
  - `displayedStepCount` integer, nullable
  - `metadata` ApertureXidStepsMetadata — Trajectory-level fields recovered from the completion blob alongside a steps window.
    - `execution_events` object[], nullable
    - `diagnostic_series` ApertureXidDiagnosticSeries[], nullable
      - `name` string, required
      - `label` string, required
      - `axis` string, required
      - `unit` string, required
      - `values` number[], required
      - `description` string, nullable
    - `diagnostic_messages` ApertureXidMessage[], nullable
      - `role` string, required
      - `content` union
        - string
        - object[]
      - `reasoning` string, nullable
      - `tool_calls` object[], nullable
      - `tool_response` object, nullable
      - `usage` object, nullable
      - `metadata` object, nullable
      - `started_at_us` number, nullable
      - `duration_seconds` number, nullable
      - `token_count` integer, nullable
      - `preview_truncated` boolean, nullable
      - `message_blob_token` string, nullable
    - `task` union
      - ApertureXidTask
        - `id` unknown
        - `task_id` unknown
        - `instruction` unknown
        - `question` unknown
        - `title` unknown
        - `type` unknown
      - string
    - `reward` object, nullable
    - `total_reward` number, nullable
    - `telemetry` object, nullable
    - `metrics` object, nullable
    - `execution_metrics` object, nullable

## Changes

- **2026-09-24** `4087cc7a74aa` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/trajectory/apis/trajectory-api/changes/api/v1/aperture/dataset-trajectories/steps/get.md)

---

[API](https://skmtc.dev/trajectory/apis/trajectory-api.md) · [All operations](https://skmtc.dev/trajectory/apis/trajectory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trajectory/apis/trajectory-api/revisions/8331f8435ce8?raw)