> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List messages

> Get a conversation's messages in chronological order.

# List a conversation's messages

Returns all the messages in a conversation, sorted chronologically (oldest first).

```http theme={null}
GET https://app.chatnorris.ai/api/v2/conversations/{conversation_id}/messages
Authorization: Bearer <your_api_key>
```

**Required scope:** `conversations:read`

***

## Path parameters

| Parameter | Type | Description |
| - | - | - |
| `conversation_id` | string | Conversation ID |

***

## Query parameters

| Parameter | Type | Description |
| - | - | - |
| `page` | integer | Page number. Default: `1` |
| `per_page` | integer | Messages per page. Default: `25`, maximum `100` |

***

## Response

```json theme={null}
{
  "status": "success",
  "data": {
    "messages": [
      {
        "id": "msg_001",
        "role": "user",
        "content": "What are your opening hours?",
        "created_at": "2026-06-28T14:01:00.000Z"
      },
      {
        "id": "msg_002",
        "role": "assistant",
        "content": "Our opening hours are Monday to Friday from 9:00 to 18:00.",
        "created_at": "2026-06-28T14:01:05.000Z"
      },
      {
        "id": "msg_003",
        "role": "agent",
        "content": "Hi Juan, I'm María from the support team. Is there anything else I can help you with?",
        "created_at": "2026-06-28T14:20:00.000Z"
      }
    ]
  },
  "pages": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 25,
    "total": 3
  }
}
```

### Response fields

| Field | Type | Description |
| - | - | - |
| `id` | string | Unique ID of the message |
| `role` | string | Who sent the message: `user` (visitor), `assistant` (AI), `agent` (human) |
| `content` | string | Message content |
| `created_at` | string | Message date and time (ISO 8601) |

***

## Common errors

| Code | Description |
| - | - |
| `NOT_FOUND` | The conversation doesn't exist or doesn't belong to your organization |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.