---
title: "List session traces"
method: GET
path: "/api/v1/sessions/{session_id}/traces"
tags: ["sessions"]
---

# List session traces

`GET /api/v1/sessions/{session_id}/traces`

Paginated external traces (for example MLflow child delegations) linked to a session.

## Path parameters

- `session_id` string, required — Identifier of the session whose traces to list.

## Query parameters

- `limit` integer — Page size
- `offset` integer — Pagination offset

## Response `200`

Successful Response

- SessionTraceListResponse — Paginated external traces for a session.
  - `items` SessionTraceItem[], required — Trace rows linked to the session.
    - `trace_id` string, required — Provider trace identifier (for example an MLflow trace id).
    - `client_request_id` string, nullable — Optional Fleet client request id correlated with the trace.
    - `turn_id` string, nullable — Chat turn id when the trace was recorded.
    - `provider` string, required — External trace provider (for example mlflow).
    - `experiment_id` string, nullable — Provider experiment id when known.
    - `experiment_name` string, nullable — Provider experiment name when known.
    - `observed_at` string, required — ISO-8601 timestamp when the trace was observed.
    - `metadata` object — Provider-specific metadata payload stored with the trace row.
  - `total` integer, required — Total matching traces.
  - `offset` integer, required — Pagination offset.
  - `limit` integer, required — Page size.
  - `has_more` boolean, required — Whether additional pages are available.

## Other responses

- `401` — Authentication is required or the provided token is invalid.
- `403` — The caller does not have permission to access this resource.
- `404` — Session not found.
- `422` — Validation Error
- `503` — Session services are unavailable because server startup is incomplete.

---

[API](https://skmtc.net/qredence/apis/fleet-rlm.md) · [All operations](https://skmtc.net/qredence/apis/fleet-rlm/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qredence/fleet-rlm/revisions/62e8c152aa18/schema)