---
title: "List messages"
method: GET
path: "/threads/{thread-id}/messages"
tags: ["Threads"]
---

# List messages

`GET /threads/{thread-id}/messages`

## Request

- Base URL: `https://api.korey.ai/api/v1`
- URL: `https://api.korey.ai/api/v1/threads/{thread-id}/messages`
- Auth: HTTP bearer

Lists active messages in a thread, ordered by created_at ASC. Pass last_id as ?after= to paginate.

## Path parameters

- `thread-id` string, uuid, required

## Query parameters

- `limit` integer
- `after` string

## Response `200`

Success

- object
  - `data` object[], required: Array of message objects.
    - `id` string, required: Unique message ID.
    - `thread_id` string, required: ID of the thread this message belongs to.
    - `role` 'user' | 'assistant' | 'summary', required: Who sent the message.
    - `contents` union[], required: Ordered list of content blocks that make up the message.
      - union
        - object
          - `type` 'text', required
          - `text` string, required
        - object
          - `type` 'image', required
          - `attachment_id` string, required
        - object
          - `type` 'document', required
          - `attachment_id` string, required
        - object
          - `type` 'user_get_choice', required
          - `tool_use_id` string, required
          - `question` string, required
          - `choices` string[], required
    - `created_at` string, required: ISO 8601 timestamp when the message was created.
    - `app_url` string, required: Direct link to this message in the Korey web app.
  - `first_id` string, nullable, required: ID of the first message in the page.
  - `last_id` string, nullable, required: ID of the last message in the page. Pass as ?after= to fetch the next page.
  - `has_more` boolean, required: True when there are more messages beyond this page.
  - `limit` integer, required: The limit applied to this request.

## Other responses

- `401`: Unauthorized — Bearer token required or invalid
- `403`: Forbidden — token does not have required scope
- `404`: Not found

---

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