---
title: "Get conversation messages"
method: GET
path: "/internal/api/chat/conversations/{conversation_id}/messages"
tags: ["CHAT"]
---

# Get conversation messages

`GET /internal/api/chat/conversations/{conversation_id}/messages`

## Request

- Base URL: `https://api.signalshq.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.signalshq.io/internal/api/chat/conversations/{conversation_id}/messages`
- Auth: OAuth 2
  - Password
  - Token URL: `/auth/login`

Retrieve paginated messages for a specific conversation.

## Path parameters

- `conversation_id` string, uuid, required: The conversation ID

## Query parameters

- `page` integer: Page number for messages (1-based)
- `limit` integer: Number of messages per page

## Response `200`

Successful Response

- ConversationMessagesResponse: Response model for conversation messages only.
  - `status` string, required
  - `conversation_id` string, uuid, required
  - `conversation_type` 'TAX_RESEARCH' | 'STATE_TAX_RESEARCH' | 'GENERAL' | 'INVOICE_HELP' | 'TEMPLATE_HELP', required
  - `page` integer, required
  - `limit` integer, required
  - `total_messages` integer, required
  - `total_pages` integer, required
  - `messages` ConversationMessage[], required
    - `message_id` string, uuid, required: Unique identifier for the message
    - `sender` 'USER' | 'SYSTEM', required
    - `message_type` 'USER' | 'SYSTEM', required
    - `message` string, nullable: Plain text message content
    - `markdown_message` string, nullable: Markdown formatted message content
    - `sequence_number` integer, required: Message sequence number in conversation
    - `created_at` string, date-time, required: When the message was created
    - `rating` string, nullable: User rating (UP/DOWN) if rated
    - `comment` string, nullable: User comment with rating if provided
    - `status` 'ACCEPTED' | 'THINKING' | 'CANCELLED' | 'COMPLETED' | 'FAILED', required
    - `is_user_input_required` boolean: Whether user input is required
    - `citations` object, nullable: Citations and references for the message

## Other responses

- `422`: Validation Error

---

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