---
title: "List Aperture Xid Trajectories"
method: GET
path: "/api/v1/aperture/xids/{xid}/trajectories"
tags: ["aperture"]
---

# List Aperture Xid Trajectories

`GET /api/v1/aperture/xids/{xid}/trajectories`

## Path parameters

- `xid` string, required

## Response `200`

Successful Response

- ApertureXidTrajectoriesResponse
  - `trajectories` ApertureXidTrajectory[], required
    - `xid` string, required
    - `trajectory_id` string, nullable
    - `trajectory_idx` integer, required
    - `status` string, nullable
    - `reward` number, nullable
    - `task` string, nullable
    - `task_gcs_uri` string, nullable
    - `step_uris` string[], required
    - `reference_step_uris` string[], required
    - `reference_trajectory_json` string, nullable
    - `metrics` union
      - string
      - object
    - `execution_metrics` union
      - string
      - object
    - `trajectory_json` string, nullable
    - `trajectory_json_gcs_uri` string, nullable
    - `telemetry_data` union
      - string
      - object
    - `reward_components` union
      - string
      - unknown[]
        - unknown
    - `error` string, nullable
    - `created_at` union
      - string
      - string, date-time
    - `updated_at` union
      - string
      - string, date-time
    - `uid` string, nullable
    - `mode` string, nullable
    - `global_step` integer, nullable
    - `storage_source` string, nullable
    - `blob_source` string, nullable
    - `training_step` integer, nullable
    - `has_reference` boolean, nullable
    - `trajectory_blob_token` string, nullable
    - `parsed` ApertureXidParsedTrajectory, required
      - `task` ApertureXidTask
        - `id` unknown
        - `task_id` unknown
        - `instruction` unknown
        - `question` unknown
        - `title` unknown
        - `type` unknown
      - `steps` ApertureXidStep[], required
        - `messages` ApertureXidMessage[], required
          - `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
        - `reward` object, nullable
        - `info` object, nullable
        - `raw_input` string, nullable
        - `raw_output` string, nullable
        - `tokens` integer[], nullable
        - `token_masks` integer[], nullable
        - `logprobs` number[], nullable
        - `train_logprobs` number[], nullable
        - `token_strings` string[], nullable
        - `advantages` number[], nullable
        - `trainable_status` string, nullable
        - `deferred_fields` string[], nullable
      - `step_count` integer, required
      - `total_reward` number, nullable
      - `reward` object, nullable
      - `metrics` object, nullable
      - `execution_metrics` object, nullable
      - `telemetry` object, nullable
  - `xid_metadata` ApertureXidMetadata
    - `user` string, nullable
    - `experiment_name` string, nullable
    - `status` string, nullable
    - `created_at` string, nullable
    - `wandb_url` string, nullable
    - `aim_url` string, nullable
    - `logging_url` string, nullable

## Changes

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

[Change history](https://skmtc.dev/trajectory/apis/trajectory-api/changes/api/v1/aperture/xids/:xid/trajectories/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)