---
title: "List messages for a chat thread"
method: GET
path: "/v1/admin/chats/threads/{threadId}/messages"
tags: ["Admin Chats"]
---

# List messages for a chat thread

`GET /v1/admin/chats/threads/{threadId}/messages`

## Path parameters

- `threadId` string, required

## Query parameters

- `limit` integer
- `cursor` string
- `direction` 'after' | 'before'

## Response `200`

Messages retrieved successfully

- ChatMessagesCursorPaginatedApiResponseDto
  - `success` boolean, required
  - `message` string, required
  - `data` object[], required
    - `id` string, uuid, required — Unique identifier of the message
    - `threadId` string, uuid, required — ID of the chat thread this message belongs to
    - `correlationId` string, uuid, nullable — ID of the message this is in reply to (if any)
    - `clientRequestId` string, uuid, nullable — Client-generated idempotency key for the originating user message; null for system messages
    - `sender` 'user' | 'system', required — Sender of the message
    - `parts` union[], required — Message parts
      - union
        - object
          - `type` 'text', required
          - `content` string, required
        - object
          - `type` 'error', required
          - `content` string, required
        - object
          - `type` 'data_request', required
          - `dataType` 'floorplan:floor_count', required
          - `constraints` object
            - `minFloors` number, required
            - `maxFloors` number, required
        - object
          - `type` 'data_request', required
          - `dataType` 'floorplan:shape', required
          - `constraints` union
            - object
              - …
            - object
              - …
        - object
          - `type` 'data_request', required
          - `dataType` 'floorplan:rooms_list', required
          - `constraints` object
            - `initialFloorCount` number, required
            - `minFloors` number, required
            - `maxFloors` number, required
            - `suggestedRooms` object[]
              - …
            - `prefilled` boolean
        - object
          - `type` 'data_request', required
          - `dataType` 'floorplan:proceed_confirmation', required
          - `constraints` unknown
        - object
          - `type` 'data_request', required
          - `dataType` 'floorplan:upload', required
          - `constraints` object, nullable
            - `acceptedMimetypes` string[]
        - object
          - `type` 'data_request', required
          - `dataType` 'floorplan:scale', required
          - `constraints` object, nullable
            - `preprocessedAssetIds` string[], required
        - object
          - `type` 'data_request', required
          - `dataType` 'floorplan:batch_upload', required
          - `data` object, required
            - `submissionId` string, uuid, required
            - `acceptedMimetypes` string[]
            - `failedEntries` object[]
              - …
        - object
          - `type` 'data_response', required
          - `dataType` 'floorplan:floor_count', required
          - `data` object, required
            - `numFloors` number, required
        - object
          - `type` 'data_response', required
          - `dataType` 'floorplan:shape', required
          - `data` union, required
            - object
              - …
            - object
              - …
            - object
              - …
        - object
          - `type` 'data_response', required
          - `dataType` 'floorplan:rooms_list', required
          - `data` object, required
            - `floors` object[], required
              - …
        - object
          - `type` 'data_response', required
          - `dataType` 'floorplan:proceed_confirmation', required
          - `data` object, required
            - `confirmed` string, required
        - object
          - `type` 'data_response', required
          - `dataType` 'floorplan:upload', required
          - `data` union, required
            - object
              - …
            - object
              - …
            - object
              - …
        - object
          - `type` 'data_response', required
          - `dataType` 'floorplan:scale', required
          - `data` object, required
            - `line` object, required
              - …
            - `length` number, required
            - `unit` 'm' | 'cm' | 'inch' | 'foot', required
        - object
          - `type` 'data_response', required
          - `dataType` 'floorplan:batch_upload', required
          - `data` object, required
            - `submissionId` string, uuid, required
            - `entries` object[], required
              - …
        - object
          - `type` 'artifact', required
          - `assetType` 'image' | 'document' | 'floorplan' | 'floorplan_template', required
          - `assetId` string, uuid, required
          - `caption` string
        - object
          - `type` 'artifacts_list', required
          - `assetType` 'image' | 'document' | 'floorplan' | 'floorplan_template', required
          - `assetIds` string[], required
          - `caption` string
        - object
          - `type` 'capability_summary', required
          - `groups` object[], required
            - `heading` string
            - `items` object[], required
              - …
        - object
          - `type` 'floorplan_batch_result', required
          - `submissionId` string, uuid, required
          - `outcomes` union[], required
            - union
              - …
    - `feedbackRating` 'positive' | 'negative', nullable — User-submitted rating on the message; only system messages may carry a rating
    - `createdAt` unknown, required
  - `meta` object, required
    - `hasNext` boolean, required — Whether there are more items after current set
    - `hasPrevious` boolean, required — Whether there are items before current set
    - `nextCursor` string, nullable, required — Cursor for next page
    - `prevCursor` string, nullable, required — Cursor for previous page
  - `timestamp` string, date-time, required

---

[API](https://skmtc.dev/maket/apis/virtual-architect-api.md) · [All operations](https://skmtc.dev/maket/apis/virtual-architect-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/maket/virtual-architect-api/revisions/b712097baa9c/schema)