---
title: "List Traces"
method: GET
path: "/admin/api/v1/traces"
tags: ["Traces"]
---

# List Traces

`GET /admin/api/v1/traces`

List traces sorted by ``started_at DESC`` with cursor pagination.

Filters compose AND-style. ``cursor`` is opaque (base64url JSON);
callers should treat it as a token to round-trip back. The list
fetches ``limit + 1`` rows so it can detect whether a next page
exists without a separate ``COUNT`` query.

## Query parameters

- `started_after` string, date-time, nullable
- `started_before` string, date-time, nullable
- `model` string, nullable
- `status` string, nullable
- `user_id` string, nullable
- `session_id` string, nullable
- `name_contains` string, nullable
- `limit` integer
- `cursor` string, nullable

## Response `200`

Successful Response

- StandaloneTraceListResponse — Envelope for the list view. ``next_cursor`` is the opaque cursor for the next page or ``None`` when the current page is the last one. ``total_estimate`` is left ``None`` on SQLite (count is expensive) and reserved for a fast PG estimate via ``pg_class.reltuples`` in a later iteration.
  - `items` StandaloneTraceListItem[]
    - `otelTraceId` string, required
    - `name` string, required
    - `startedAt` string, date-time, required
    - `endedAt` string, date-time, nullable
    - `latencyMs` number, nullable
    - `totalTokens` integer, nullable
    - `totalCostUsd` number, nullable
    - `models` string[]
    - `status` string, nullable
    - `userId` string, nullable
    - `sessionId` string, nullable
    - `tags` string[]
  - `nextCursor` string, nullable
  - `totalEstimate` integer, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/idun-group/apis/idun-agent-engine-server.md) · [All operations](https://skmtc.net/idun-group/apis/idun-agent-engine-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/idun-group/idun-agent-engine-server/revisions/8909cd73cc1c/schema)