---
title: "Get Aperture Xid Stream"
method: GET
path: "/api/v1/aperture/xids/{xid}/stream"
tags: ["aperture"]
---

# Get Aperture Xid Stream

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

## Path parameters

- `xid` string, required

## Query parameters

- `mode` 'training' | 'eval'
- `after` string

## Response `200`

Successful Response

- ApertureRunStream
  - `samples` ApertureStreamSample[], required
    - `id` string, required
    - `tid` string, nullable, required
    - `uid` string, nullable, required
    - `sourceXid` string, nullable, required
    - `trajectoryIndex` integer, nullable, required
    - `policyStep` integer, nullable, required
    - `collectedStep` integer, nullable, required
    - `trainedStep` integer, nullable, required
    - `state` 'pending' | 'selected' | 'trained' | 'rejected' | 'collected', required
    - `rejection` string, nullable, required
    - `reward` number, nullable, required
    - `receivedAt` string, nullable, required
    - `createdAt` string, nullable, required
    - `duration` number, nullable, required
    - `endedAt` string, nullable
    - `tokens` integer, nullable, required
    - `task` string, nullable, required
  - `total` integer, required
  - `counts` ApertureStreamCounts, required
    - `pending` integer
    - `selected` integer
    - `trained` integer
    - `rejected` integer
    - `collected` integer
  - `batches` ApertureStreamBatch[], required
    - `step` integer, required
    - `count` integer, required
  - `checkpoints` ApertureStreamCheckpoint[], required
    - `id` string, required
    - `step` integer, required
    - `createdAt` string, nullable, required
    - `updateStartedAt` string, nullable
    - `updateEndedAt` string, nullable
  - `next` string, nullable, required
  - `source` 'samples' | 'trajectories' | 'firestore', required
  - `order` 'received' | 'created' | 'id', required

## Changes

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

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