---
title: "Listar histórico de conversas"
method: GET
path: "/v2/messages/history"
tags: ["conversas-v2-messages"]
---

# Listar histórico de conversas

`GET /v2/messages/history`

ℹ️ API disponível apenas para o plano Advanced.

ℹ️ Este recurso requer criptografia.

Listar histórico de conversas.

**Paginação:** por offset (parâmetros `page` e `limit`). Não há cursor.
O limite máximo por requisição é **100** registros.
Se `limit` for informado e ≤ 100, usa esse valor; caso contrário o padrão é 15.

Para obter as próximas páginas, incremente o parâmetro `page` (ex.: `page=1`, `page=2`,
`page=3`) e mantenha o mesmo `limit`.
Exemplo: `limit=50&page=2` retorna os registros de 51 a 100.

## Query parameters

- `limit` integer
- `page` integer
- `channel` string[]
- `customer_id` string, hash, required
- `end_date` string, date
- `sent_by` string[]
- `start_date` string, date
- `type` string[]

## Response `200`

Histórico de mensagens (criptografado)

- object
  - `messages` string, required — Lista criptografada com as mensagens do contato.

## Other responses

- `400` — Bad request
- `401` — Access Token missing or invalid
- `403` — Not authorized to access such resource
- `404` — Resource not found
- `422` — Unprocessable Content
- `500` — Internal Server Error

---

[API](https://skmtc.net/rdstation/apis/webhook-service.md) · [All operations](https://skmtc.net/rdstation/apis/webhook-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rdstation/webhook-service/revisions/3867c21388e8/schema)