---
title: "List"
method: GET
path: "/chrt_gpt/conversations/list/v1"
tags: ["/chrt_gpt"]
---

# List

`GET /chrt_gpt/conversations/list/v1`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/chrt_gpt/conversations/list/v1`
- Auth: HTTP bearer

Lists the caller's ChrtGPT conversations, most recently active first by default, with optional search over summaries, titles, and order identifiers. | authz: allowed_org_types=[shipper, provider], min_org_role=operator | () -> (ChrtGPTConversationListRes)

## Query parameters

- `sort_by` 'updated_at' | 'created_at'
- `sort_order` 'asc' | 'desc': Sort order for query results
- `page` integer
- `page_size` integer
- `search` string, nullable: Full-text search query for conversation summary, title, order short IDs, AWB numbers, or off-CHRT reference IDs.

## Response `200`

Successful Response

- ChrtGPTConversationListRes
  - `items` ChrtGPTConversation1[], required
    - `schema_version` 1, required
    - `_id` string, required
    - `org_id` string, required: Must be a string starting with `org_`
    - `user_id` string, required: Must be a string starting with `user_`
    - `title` string, required
    - `title_source` 'fallback' | 'ai' | 'user', required
    - `summary` string, nullable
    - `summarized_turn_count` integer
    - `order_short_ids` string[]
    - `awb_numbers` string[]
    - `off_chrt_reference_ids` string[]
    - `context_tokens` integer, nullable
    - `conversation_s3_object_metadata_ids` string[]
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `total_count` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-29** `6f428e2e2b98`: 1 info
  - added the optional property `items/items/conversation_s3_object_metadata_ids` to the response with the `200` status
- **2026-10-13** `2cbb4c8fec86`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/chrt/apis/chrt-fastapi/changes/chrt_gpt/conversations/list/v1/get.md)

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) - [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/chrt/apis/chrt-fastapi/revisions/6f428e2e2b98?raw)