---
title: "Get"
method: GET
path: "/chrt_gpt/conversations/v1/{conversation_id}"
tags: ["/chrt_gpt"]
---

# Get

`GET /chrt_gpt/conversations/v1/{conversation_id}`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/chrt_gpt/conversations/v1/{conversation_id}`
- Auth: HTTP bearer

Gets one of the caller's ChrtGPT conversations with its history of messages, tool calls, and web searches. | authz: allowed_org_types=[shipper, provider], min_org_role=operator | () -> (ChrtGPTConversationRes)

## Path parameters

- `conversation_id` string, required

## Response `200`

Successful Response

- ChrtGPTConversationRes
  - `conversation` 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
  - `items` ChrtGPTHistoryItem[], required: The conversation's history, oldest first. Reasoning and compaction items are omitted.
    - union
      - ChrtGPTUserMessageItem
        - `type` 'user_message'
        - `speech` boolean, required: Said aloud on a Charlie call rather than typed.
        - `text` string, required: A file upload adds one message, kept with its tags: <object_upload>, whose <object_id> is the conversation S3 object metadata id to render the file from, followed by what the file is.
      - ChrtGPTAssistantMessageItem
        - `type` 'assistant_message'
        - `speech` boolean, required: Said aloud on a Charlie call: the stored text was wrapped in speech tags.
        - `item_id` string, nullable, required: Matches the item_id of the text_delta events that streamed it. None for Charlie's own lines, which never stream.
        - `text` string, required
      - ChrtGPTToolCalledEvent: ChrtGPT called a chrt-mcp tool; its tool_output event follows.
        - `type` 'tool_called'
        - `call_id` string, required
        - `name` string, required
        - `arguments` string, required: JSON-encoded tool arguments.
      - ChrtGPTToolOutputEvent
        - `type` 'tool_output'
        - `call_id` string, required: The call_id of the tool_called event.
        - `output` string, required: Text of the tool result: the tool's JSON output or an error message.
      - ChrtGPTWebSearchEvent: OpenAI ran a web search for ChrtGPT; it has no tool_output event.
        - `type` 'web_search'
        - `item_id` string, required
        - `action` 'search' | 'open_page' | 'find_in_page', required
        - `queries` string[], required: What was searched for, on the web or within a page. OpenAI omits it on some searches.
        - `url` string, nullable, required: The page opened or searched within.
  - `context_limit_tokens` integer, required: The limit for conversation.context_tokens, as on the completed event.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-29** `6f428e2e2b98`: 1 breaking, 3 info
  - response property `items/items/oneOf[subschema #2: ChrtGPTAssistantMessageItem]/item_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the optional property `conversation/conversation_s3_object_metadata_ids` to the response with the `200` status
  - added the required property `items/items/oneOf[subschema #1: ChrtGPTUserMessageItem]/speech` to the response with the `200` status
  - added the required property `items/items/oneOf[subschema #2: ChrtGPTAssistantMessageItem]/speech` 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/v1/:conversation_id/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)