---
title: "List conversations"
method: GET
path: "/api/v0/agent/traces/sessions"
tags: ["Agent Traces"]
---

# List conversations

`GET /api/v0/agent/traces/sessions`

## Request

- Base URL: `https://api.outerport.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.outerport.com/api/v0/agent/traces/sessions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/outerport/apis/outerport-api/docs/api/v0/agent/traces/sessions/get.ts> (a function with typed inputs; its response is checked against the schema)

The conversations the caller may read: their own, and every member's of each organization they are an admin of, newest activity first, with each one's owner and rating counts.

## Query parameters

- `limit` integer
- `offset` integer
- `q` string, nullable: Search conversation names, message text, a session ID, or the owner's name, email or department.

## Response `200`

Successful Response

- TraceSessionListResponse: The conversations the viewer may read: their own, and their organizations' members' when they are an admin.
  - `sessions` TraceSessionResponse[], required
    - `id` string, uuid, required: The ID of the session.
    - `name` string, nullable: The session's name.
    - `message_count` integer, required: Number of messages in the session.
    - `user` TraceUserResponse, required: The person a conversation in Logs → Traces belongs to.
      - `id` string, uuid, required: The user's public ID.
      - `name` string, nullable: The user's display name.
      - `email` string, nullable: The user's email address.
      - `department` string, nullable: The user's department in the viewer's organization; null when none is set.
      - `is_viewer` boolean: Whether this is the user making the request.
    - `good_count` integer, required: Answers in the conversation rated 'good'.
    - `bad_count` integer, required: Answers in the conversation rated 'bad'.
    - `created_at` string, date-time, required: When the session was created.
    - `updated_at` string, date-time, required: When the session was last active.
  - `pagination` PaginationMetadata, required
    - `total` integer, required: The total number of items matching the query.
    - `limit` integer, required: The maximum number of items per page.
    - `offset` integer, required: The number of items skipped.
    - `has_more` boolean, required: Whether there are more items available.

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-12** `08b5bf6f7f18`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/outerport/apis/outerport-api/changes/api/v0/agent/traces/sessions/get.md)

---

[API](https://skmtc.dev/outerport/apis/outerport-api.md) - [All operations](https://skmtc.dev/outerport/apis/outerport-api/llms.txt) - [OpenAPI document](https://skmtc.dev/outerport/apis/outerport-api/revisions/08b5bf6f7f18?raw)