---
title: "List trajectories (agent key required)"
method: GET
path: "/agent/v1/trajectories"
tags: ["Agent Sandbox"]
---

# List trajectories (agent key required)

`GET /agent/v1/trajectories`

Every call made with an issued agent key is recorded; calls sharing an X-Agent-Run-Id header (or a rolling 30-minute activity window per key) form a trajectory. Newest first, cursor-paginated. Keyless free-tier traffic is never recorded. Live data - outside the byte-determinism guarantee.

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

Runs with { run_id, started_at, ended_at, calls, error_calls }

## Other responses

- `401` — No agent key: { error: 'agent_key_required' }

---

[API](https://skmtc.net/reqres/apis/reqres-api.md) · [All operations](https://skmtc.net/reqres/apis/reqres-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reqres/reqres-api/revisions/e5ced6578853/schema)