> ## 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.

# Listar mensajes

> Obtener los mensajes de una conversación en orden cronológico.

# Listar mensajes de una conversación

Devuelve todos los mensajes de una conversación, ordenados cronológicamente (más antiguos primero).

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

**Scope requerido:** `conversations:read`

***

## Path parameters

| Parámetro         | Tipo   | Descripción           |
| ----------------- | ------ | --------------------- |
| `conversation_id` | string | ID de la conversación |

***

## Query parameters

| Parámetro  | Tipo    | Descripción                                      |
| ---------- | ------- | ------------------------------------------------ |
| `page`     | integer | Número de página. Default: `1`                   |
| `per_page` | integer | Mensajes por página. Default: `25`, máximo `100` |

***

## Respuesta

```json theme={null}
{
  "status": "success",
  "data": {
    "messages": [
      {
        "id": "msg_001",
        "role": "user",
        "content": "¿Cuáles son los horarios de atención?",
        "created_at": "2026-06-28T14:01:00.000Z"
      },
      {
        "id": "msg_002",
        "role": "assistant",
        "content": "Nuestro horario de atención es de lunes a viernes de 9:00 a 18:00 hs.",
        "created_at": "2026-06-28T14:01:05.000Z"
      },
      {
        "id": "msg_003",
        "role": "agent",
        "content": "Hola Juan, soy María del equipo de soporte. ¿En qué más puedo ayudarte?",
        "created_at": "2026-06-28T14:20:00.000Z"
      }
    ]
  },
  "pages": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 25,
    "total": 3
  }
}
```

### Campos de respuesta

| Campo        | Tipo   | Descripción                                                                    |
| ------------ | ------ | ------------------------------------------------------------------------------ |
| `id`         | string | ID único del mensaje                                                           |
| `role`       | string | Quién envió el mensaje: `user` (visitante), `assistant` (IA), `agent` (humano) |
| `content`    | string | Contenido del mensaje                                                          |
| `created_at` | string | Fecha y hora del mensaje (ISO 8601)                                            |

***

## Errores comunes

| Code        | Descripción                                                |
| ----------- | ---------------------------------------------------------- |
| `NOT_FOUND` | La conversación no existe o no pertenece a tu organización |