---
title: "One conversation and its messages"
method: GET
path: "/assistant/conversations/{id}"
tags: ["assistant"]
---

# One conversation and its messages

`GET /assistant/conversations/{id}`

## Request

- Base URL: `https://api.gogoscreen.com/api/v1`
- URL: `https://api.gogoscreen.com/api/v1/assistant/conversations/{id}`
- Auth: HTTP bearer

One conversation of this account with its last fifty messages, oldest first. A conversation belonging to another account is a 404, never a 403: this surface does not answer whether an id exists.

## Path parameters

- `id` string, uuid, required

## Response `200`

One conversation and its messages

- object
  - `conversation` object, required
    - `createdAt` string, date-time, required
    - `id` string, required: The conversation's id. Pass it as `conversationId` to keep asking in the same thread.
    - `lastMessageAt` string, date-time, nullable, required: When the thread was last written to. Null on a conversation with no messages yet.
    - `messageCount` integer, required: How many questions the customer has asked in this thread. The per-conversation cap counts this, not the replies.
    - `status` 'open' | 'closed' | 'handed_off', required: `open` takes another question. `closed` and `handed_off` both refuse one with 409 `conversation_closed`; start a new conversation.
  - `messages` object[], required
    - `content` string, required: Plain text. The assistant writes no HTML, no markdown headings and no links off this product.
    - `createdAt` string, date-time, required
    - `handoffSuggested` boolean, required: The assistant believes a person should take this. Offer the hand-off; it is never taken automatically.
    - `id` string, required
    - `role` 'user' | 'assistant', required
    - `topic` string, nullable, required: The assistant's own label for what the question was about — one of product, billing, account, api, troubleshooting, escalation, off_topic. Null on a customer's turn.

## Other responses

- `400`: `validation_failed` — That request is not valid.
- `401`: `unauthorized` — Authentication is required.
- `403`: `forbidden_scope` — This credential does not carry the scope this operation needs. · `feature_disabled` — That feature is not available.
- `404`: `not_found` — No such resource. · `conversation_not_found` — No such conversation.
- `429`: `rate_limited` — Too many requests. Try again shortly.
- `500`: `internal_error` — Something went wrong. Try again.

---

[API](https://skmtc.dev/gogoscreen/apis/gogoscreen-api.md) · [All operations](https://skmtc.dev/gogoscreen/apis/gogoscreen-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gogoscreen/apis/gogoscreen-api/revisions/2fd812319d75?raw)