---
title: "List the messages of a stored chat completion"
method: GET
path: "/v1/chat/completions/{completion_id}/messages"
tags: ["chat"]
---

# List the messages of a stored chat completion

`GET /v1/chat/completions/{completion_id}/messages`

List the request messages a stored completion was created with.

A stored completion keeps the full conversation it was asked with, so the
latest completion of a conversation reconstructs the entire history; the
completion's own answer is its choice message, not part of this list.

## Path parameters

- `completion_id` string, required — ID of the chat completion

## Response `200`

The stored request messages, oldest first

- CompletionMessageList — The stored request messages of a completion, oldest first. A stored completion keeps the full conversation it was asked with, so the latest completion of a conversation carries the entire history; its answer is the completion's own choice message, not part of this list.
  - `object` 'list'
  - `data` union[]
    - union
      - SystemMessage
        - `role` 'system', required
        - `content` union, required
          - string
          - TextPart[]
            - `type` 'text'
            - `text` string, required
      - DeveloperMessage — Alias of the system role; forwarded to the provider as system instructions.
        - `role` 'developer', required
        - `content` union, required
          - string
          - TextPart[]
            - `type` 'text'
            - `text` string, required
      - UserMessage
        - `role` 'user', required
        - `content` union, required
          - string
          - TextPart[]
            - `type` 'text'
            - `text` string, required
      - AssistantMessageOutput
        - `role` 'assistant', required
        - `content` union
          - string
          - TextPart[]
            - `type` 'text'
            - `text` string, required
        - `tool_calls` MessageToolCall[]
          - `id` string, required
          - `type` 'function'
          - `function` ToolCallFunction, required
            - `name` string, required
            - `arguments` string, required
        - `reasoning_content` string, nullable
        - `annotations` union[]
          - union
            - FileCitation — The OpenAI ``file_citation`` annotation, plus the chunk it points at. ``chunk_id`` is the same ``file_id:chunk_index`` reference every hosted result carries, and ``store_id`` the store whose index holds the chunk; the cited text and score are on the included tool results.
              - …
            - UrlCitation — The OpenAI ``url_citation`` annotation, for a hit of the web store; ``chunk_id`` as on the hosted result.
              - …
      - ToolMessage — Result of a function tool call, sent back by the caller.
        - `role` 'tool', required
        - `content` union, required
          - string
          - TextPart[]
            - `type` 'text'
            - `text` string, required
        - `tool_call_id` string, required
  - `has_more` boolean

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-23** `824e59bfac1e` — 7 breaking, 1 warning, 1 info
  - added `#/components/schemas/FileCitation, #/components/schemas/UrlCitation` to the `data/items/oneOf[subschema #4: AssistantMessage]/annotations/items/` response property `oneOf` list for the response status `200`
  - the `data/items/oneOf[subschema #4: AssistantMessage]/annotations/items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `data/items/oneOf[subschema #4: AssistantMessage]/annotations/items/chunk_id` from the response with the `200` status
  - removed the required property `data/items/oneOf[subschema #4: AssistantMessage]/annotations/items/file_id` from the response with the `200` status
  - …5 more
- **2026-09-11** `ce3609b10ef1` — 1 info
  - added the optional property `data/items/oneOf[subschema #4: AssistantMessage]/annotations` to the response with the `200` status
- **2026-08-19** `f66774ddecfc` — 1 info
  - added the optional property `data/items/oneOf[subschema #4: AssistantMessage]/reasoning_content` to the response with the `200` status
- **2026-08-13** `d47e1d852549` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mixedbread/apis/mxbai-omni/changes/v1/chat/completions/:completion_id/messages/get.md)

---

[API](https://skmtc.dev/mixedbread/apis/mxbai-omni.md) · [All operations](https://skmtc.dev/mixedbread/apis/mxbai-omni/llms.txt) · [OpenAPI document](https://skmtc.dev/mixedbread/apis/mxbai-omni/revisions/824e59bfac1e?raw)