---
title: "GET /tracer/trace/list_traces_of_session/"
method: GET
path: "/tracer/trace/list_traces_of_session/"
tags: ["tracer"]
---

# GET /tracer/trace/list_traces_of_session/

`GET /tracer/trace/list_traces_of_session/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/tracer/trace/list_traces_of_session/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

List traces filtered by project ID with optimized queries.

## Query parameters

- `project_id` string, uuid
- `project_version_id` string, uuid
- `session_id` string, uuid
- `filters` string
- `page_number` integer
- `page_size` integer
- `cursor` string
- `cursor_mode` boolean
- `attribute_keys` string
- `allow_sampled` boolean
- `interval` string

## Response `200`

OK

- TraceObserveListResponse
  - `status` boolean, required
  - `result` TraceObserveListResult, required
    - `metadata` TraceObserveListMetadata, required
      - `total_rows` integer, required
      - `total_rows_exact` integer, nullable
      - `total_rows_is_lower_bound` boolean
      - `has_more` boolean
      - `next_cursor` string, nullable
      - `next_cursor_fingerprint` string, nullable
      - `query_complete` boolean
      - `query_status` 'complete' | 'degraded'
      - `query_error_code` string, nullable
      - `query_elapsed_ms` number
      - `query_count` integer
      - `query_rows_returned` integer
      - `query_result_payload_bytes` integer
      - `query_applied_filter_version` 'canonical-json-sha256-v1'
      - `query_applied_filter_sha256` string
      - `query_applied_filter_count` integer
      - `query_exact` boolean
      - `ordering_exact` boolean
    - `table` object[], required: Observe eval bool and choice cells are counts of completed attempts; a detail eval_rollup separately selects the latest completed row per span.
    - `config` TraceObserveColumnConfig[], required
      - `id` string, required
      - `name` string, required
      - `is_visible` boolean, required
      - `group_by` string, nullable
      - `output_type` string, nullable
      - `reverse_output` boolean, nullable
      - `annotation_label_type` string, nullable
      - `choices` string[], nullable
      - `settings` object, nullable: Any valid JSON value.
      - `choices_map` object, nullable: Any valid JSON value.
      - `eval_template_id` string, nullable
      - `target_type` 'span' | 'trace', nullable
      - `annotators` object, nullable: Any valid JSON value.
      - `source_field` string, nullable
      - `parent_eval_id` string, nullable
      - `property_id` string, nullable
      - `property_kind` string, nullable
      - `property_source` string, nullable

## Other responses

- `400`: Bad Request
- `422`: Unprocessable Entity
- `500`: Internal Server Error
- `503`: Service Unavailable
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)