---
title: "List Production Traces"
method: GET
path: "/api/v1/agents/{agent_id}/traces"
tags: ["agents"]
---

# List Production Traces

`GET /api/v1/agents/{agent_id}/traces`

## Path parameters

- `agent_id` string, required

## Query parameters

- `cursor` string, nullable
- `limit` integer
- `queue` 'all' | 'needs_review' | 'reviewed'

## Response `200`

Successful Response

- AgentProductionTraceListResponse
  - `items` AgentProductionTrace[], required
    - `agent_id` string, required
    - `trajectory` TrajectoryMetadata, required
      - `trajectory_id` string, required
      - `organization_id` string, required
      - `dataset_id` string, nullable
      - `dataset_name` string, nullable
      - `dataset_source` string, nullable
      - `dataset_gcs_prefix` string, nullable
      - `trace_id` string, nullable
      - `model_id` string, nullable
      - `model_association_source` string, nullable
      - `model_association_metadata` object, nullable
      - `source` string, required
      - `status` string, nullable
      - `reward` number, nullable
      - `num_steps` integer, nullable
      - `created_at` string, required
      - `training_run_id` string, nullable
      - `xid` string, nullable
      - `task_id` string, nullable
      - `policy_step` integer, nullable — Sampled policy step, not optimizer step.
      - `rollout` TrajectoryRolloutStatus
        - `rollout_id` string, required
        - `status` string, required — Recorded Rollout Service state, such as IN_PROGRESS or FAILED.
        - `termination_reason` string, nullable — Recorded rollout termination enum.
        - `harness_diagnostic` HarnessDiagnostic
          - `exception_chain` string[]
          - `locations` string[]
          - `category` 'timeout' | 'connection' | 'rate_limit' | 'authentication' | 'server' | 'other', required
          - `preceding_tracebacks` TracebackDiagnostic[]
            - `exception_chain` string[]
            - `locations` string[]
          - `exit_code` integer, nullable
    - `attached_at` string, required — Time the canonical trajectory was recorded.
    - `updated_at` string, required
    - `feedback_score` number, nullable
    - `feedback_text` string, nullable
  - `next_cursor` string, nullable
  - `has_more` boolean, required
  - `total_count` integer, required
  - `reviewed_count` integer, required

## Changes

- **2026-09-28** `1efa21f7aeb8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/trajectory/apis/trajectory-api/changes/api/v1/agents/:agent_id/traces/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)