---
title: "List Messages"
method: GET
path: "/messages"
tags: ["Messages"]
---

# List Messages

`GET /messages`

Endpoint to list messages with optional filters, pagination, and sorting.

## Query parameters

- `team_id` string, uuid
- `date_created_from` string, date-time
- `date_created_to` string, date-time
- `date_updated_from` string, date-time
- `date_updated_to` string, date-time
- `question` string
- `answer` string
- `conversation_id` string, uuid
- `limit` integer
- `offset` integer
- `order_by` 'date_created' | 'date_updated'
- `ascending` integer

## Response `200`

Successful Response

- MessageListResponse
  - `results` Message[], required
    - `id` string, uuid
    - `date_created` string, date-time
    - `date_updated` string, date-time
    - `question` string, required — The question asked in the message.
    - `answer` string, required — The answer provided in response to the question.
    - `sources` object[] — The list of sources contributing to this answer.
    - `conversation_id` string, uuid, required — The ID of the conversation to which the message belongs.
    - `was_answered` boolean — Flag indicating whether the question was answered or not.
    - `reaction` 'thumbs_up' | 'thumbs_down' | 'no_reaction' — An enumeration.
    - `show_data_collection` boolean — Flag indicating whether to show data collection form.
    - `user_id` string, uuid, required — The ID of the user associated with the message.
    - `agent_conversation_id` string, uuid — The ID of the agent associated with the message.
  - `pagination` Pagination, required
    - `limit` integer
    - `offset` integer
  - `filters` MessageFilter, required
    - `date_created_from` string, date-time
    - `date_created_to` string, date-time
    - `date_updated_from` string, date-time
    - `date_updated_to` string, date-time
    - `question` string
    - `answer` string
    - `conversation_id` string, uuid
  - `last_model_used` 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-4-omnimodel-mini' | 'gpt-4-omnimodel' | 'gpt-4-omnimodel-128k' | 'gpt-4-turbo' | 'gpt-4-turbo-128k' | 'gpt-4' | 'gpt-4-32k' | 'gpt-3.5-turbo' | 'gpt-3.5-turbo-1106' | 'gpt-3.5-turbo-16k' | 'falcon' | 'mistral' | 'wizardlm' | 'gemma' | 'llama2' | 'llama3' | 'llama3_8b' | 'cohere' | 'claude_3_opus_9k' | 'claude_3_opus_32k' | 'claude_3_opus_128k' | 'claude_3_opus_200k' | 'claude_3_sonnet' | 'claude_3_dot_5_sonnet' | 'claude_3_haiku' | 'claude_3_dot_7_sonnet' | 'claude_4_opus' | 'claude_4_sonnet' | 'gemini-2.0-flash' | 'gemini-2.5-flash' | 'gemini-2.0-flash-lite' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude_4_dot_5_sonnet' | 'claude_4_dot_1_opus' | 'claude_4_dot_5_haiku' | 'gemini-2.5-pro' | 'gemini-2.5-flash-lite' | 'gpt-5.1' | 'gemini-3-pro' | 'gpt-5.2' | 'gpt-5.4' | 'gemini-3-flash' | 'claude_4_dot_6_opus' | 'claude_4_6_sonnet' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'gpt-5.5' | 'gpt-5.6-sol' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'claude_4_7_opus' | 'claude_4_8_opus' | 'claude_5_opus' | 'claude_5_sonnet' — An enumeration.
  - `total_count` integer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/dante-ai/apis/dante-ai-api.md) · [All operations](https://skmtc.net/dante-ai/apis/dante-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dante-ai/dante-ai-api/versions/38b6c9a4246d/schema)