---
title: "List messages (chronological)"
method: GET
path: "/conversations/{id}/messages"
tags: ["Messages"]
---

# List messages (chronological)

`GET /conversations/{id}/messages`

## Request

- Base URL: `https://muro.chat/api/v1`
- URL: `https://muro.chat/api/v1/conversations/{id}/messages`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `cursor` string
- `since` string, date-time

## Response `200`

A page of messages.

- object
  - `object` 'list', required
  - `data` Message[], required
    - `object` 'message'
    - `id` string
    - `conversation_id` string
    - `sender_type` 'visitor' | 'agent' | 'system' | 'note'
    - `sender_id` string, nullable
    - `content` string
    - `attachments` unknown[]
      - unknown
    - `created_at` string, date-time
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Invalid query parameter.
- `404`: Conversation not found.

---

[API](https://skmtc.dev/muro/apis/muro-rest-api.md) · [All operations](https://skmtc.dev/muro/apis/muro-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/muro/apis/muro-rest-api/revisions/94ccdc79d61a?raw)