---
title: "Retrieve conversation"
method: GET
path: "/conversations/{id}"
tags: ["Conversations"]
---

# Retrieve conversation

`GET /conversations/{id}`

## Path parameters

- `id` string, required

## Response `200`

The conversation

- InconvoConversation
  - `id` string, required
  - `userIdentifier` string, nullable — Unique identifier for the end-user (may be null for legacy conversations)
  - `userContext` object, required
  - `messages` Message[], required
    - `id` string — Present on Inconvo responses only
    - `type` 'text' | 'chart' | 'table', required
    - `message` string, required
    - `chart` Chart — Charts use vega V5 spec https://vega.github.io/schema/vega/v5.json
    - `table` Table
      - `head` string[], required
      - `body` array[], required
        - string[]

## Changes

- **2026-01-21** `930d22e210f3` — 2 breaking
  - the response property `userIdentifier` became nullable for the status `200`
  - the response property `userIdentifier` became optional for the status `200`
- **2026-01-21** `c0068facc07b` — 1 info
  - added the required property `userIdentifier` to the response with the `200` status
- **2026-01-15** `b59ae9e9a8ec` — 1 breaking, 1 info
  - removed the required property `context` from the response with the `200` status
  - added the required property `userContext` to the response with the `200` status
- **2026-01-05** `e430e9ba0027` — 5 breaking
  - removed the required property `messages/items/chart/data` from the response with the `200` status
  - removed the required property `messages/items/chart/title` from the response with the `200` status
  - removed the required property `messages/items/chart/type` from the response with the `200` status
  - removed the required property `messages/items/chart/xLabel` from the response with the `200` status
  - …1 more
- **2025-10-28** `9fa824afdaab` — 1 breaking, 2 info
  - the `messages/items/chart/data` response's property type changed from `array` to `object` for status `200`
  - added the required property `messages/items/chart/data/datasets` to the response with the `200` status
  - added the required property `messages/items/chart/data/labels` to the response with the `200` status

[Change history](https://skmtc.dev/inconvoai/apis/inconvo-conversations-api/changes/conversations/:id/get.md)

---

[API](https://skmtc.dev/inconvoai/apis/inconvo-conversations-api.md) · [All operations](https://skmtc.dev/inconvoai/apis/inconvo-conversations-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/inconvoai/inconvo-conversations-api/revisions/d97ebdf80ef8/schema)