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

> Obter as mensagens de uma conversa em ordem cronológica.

# Listar mensagens de uma conversa

Retorna todas as mensagens de uma conversa, ordenadas cronologicamente (as mais antigas primeiro).

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

**Escopo necessário:** `conversations:read`

***

## Path parameters

| Parâmetro | Tipo | Descrição |
| - | - | - |
| `conversation_id` | string | ID da conversa |

***

## Query parameters

| Parâmetro | Tipo | Descrição |
| - | - | - |
| `page` | integer | Número da página. Default: `1` |
| `per_page` | integer | Mensagens por página. Default: `25`, máximo `100` |

***

## Resposta

```json theme={null}
{
  "status": "success",
  "data": {
    "messages": [
      {
        "id": "msg_001",
        "role": "user",
        "content": "Qual é o horário de atendimento?",
        "created_at": "2026-06-28T14:01:00.000Z"
      },
      {
        "id": "msg_002",
        "role": "assistant",
        "content": "Nosso horário de atendimento é de segunda a sexta, das 9h às 18h.",
        "created_at": "2026-06-28T14:01:05.000Z"
      },
      {
        "id": "msg_003",
        "role": "agent",
        "content": "Olá, Juan, aqui é a María, da equipe de suporte. Em que mais posso ajudar você?",
        "created_at": "2026-06-28T14:20:00.000Z"
      }
    ]
  },
  "pages": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 25,
    "total": 3
  }
}
```

### Campos da resposta

| Campo | Tipo | Descrição |
| - | - | - |
| `id` | string | ID único da mensagem |
| `role` | string | Quem enviou a mensagem: `user` (visitante), `assistant` (IA), `agent` (humano) |
| `content` | string | Conteúdo da mensagem |
| `created_at` | string | Data e hora da mensagem (ISO 8601) |

***

## Erros comuns

| Code | Descrição |
| - | - |
| `NOT_FOUND` | A conversa não existe ou não pertence à sua organização |


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