---
title: "List Messages"
method: GET
path: "/v1/threads/{thread_id}/messages"
tags: ["Message Threads"]
---

# List Messages

`GET /v1/threads/{thread_id}/messages`

## Path parameters

- `thread_id` string, required

## Response `200`

Successful Response

- Message[]
  - `id` string, uuid, required
  - `tenant_id` string, required
  - `created_by` string, nullable
  - `created_by_username` string, nullable
  - `created_on` string, date-time, nullable
  - `updated_at` string, date-time, nullable
  - `thread_id` string, uuid, required
  - `assistant` AssistantInfo, required
    - `assistant_id` string, uuid, nullable
    - `assistant_name` string, nullable
    - `is_default` boolean
  - `parent_message_id` string, uuid, nullable
  - `role` string, required
  - `content` AssistantContent[], required
    - `response_type` 'conversational_search' | 'text' | 'image' | 'option' | 'pause' | 'iframe' | 'connect_to_agent' | 'suggestion' | 'channel_transfer' | 'search' | 'user_defined' | 'video' | 'audio' | 'date' | 'inline_error' | 'chat_with_docs_upload' | 'disconnected_apps' | 'forms' | 'form_operation' | 'document_processing_response', required
    - `json_schema` object, nullable
    - `ui_schema` object, nullable
    - `form_data` object, nullable
    - `id` string, nullable
    - `form_operation` string, nullable
    - `sub_type` string, nullable
    - `event_type` string, nullable
    - `dps_payload_id` string, nullable
  - `mentions` union[], nullable
    - union
      - Mention
        - `type` string, required
        - `id` string, uuid, required
        - `name` string, required
      - AssistantMention
        - `assistant_id` string, uuid, required
        - `assistant_name` string, required
  - `document_ids` string[], nullable
  - `additional_properties` AdditionalProperties
    - `wxa_message` object, nullable
    - `display_properties` DisplayProperties
      - `skip_render` boolean
      - `is_async` boolean
      - `form_operation` string
    - `tool_calls` object[], nullable
    - `tool_call_id` string, nullable
    - `tool_name` string, nullable
    - `wxo_connection_status` WxoConnectionStatus
      - `connection_status` string
      - `connection_message` string
  - `context` object, nullable
  - `step_history` object[], nullable
  - `message_state` object, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ibm/apis/wxo-server-api.md) · [All operations](https://skmtc.net/ibm/apis/wxo-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ibm/wxo-server-api/revisions/82c114c37196/schema)