---
title: "Lista conversas (inbox)"
method: GET
path: "/v1/conversations"
tags: ["conversations"]
---

# Lista conversas (inbox)

`GET /v1/conversations`

Requer plano PRO+ e número dedicado.

## Query parameters

- `page` integer
- `size` integer
- `status` string
- `leadStatus` string

## Response `200`

Lista paginada de conversas

- ConversationListResponse
  - `content` ConversationListItem[], required
    - `id` string, uuid
    - `customerPhone` string
    - `customerName` string, nullable
    - `status` string
    - `lastInteractionAt` string, date-time, nullable
    - `windowExpiresAt` string, date-time, nullable
    - `isWindowOpen` boolean
    - `createdAt` string, date-time, nullable
    - `leadStatus` string, nullable
    - `leadScore` integer, nullable
    - `leadSummary` string, nullable
    - `originatingCampaignId` string, uuid, nullable
    - `qualifierCompletedAt` string, date-time, nullable
  - `page` integer, required
  - `size` integer, required
  - `totalElements` integer, required
  - `totalPages` integer, required

## Other responses

- `401` — Token ausente ou inválido
- `403` — Sem permissão (plano, escopo, status da conta)

## Changes

- **2026-05-25** `4e426b85f784` — 6 warning, 11 info
  - for the `query` request parameter `size`, the max was set to `100.00`
  - for the `query` request parameter `page`, the min was set to `0.00`
  - for the `query` request parameter `size`, the min was set to `1.00`
  - deleted the `query` request parameter `search`
  - …13 more

[Change history](https://skmtc.dev/ararahq/apis/ararahq-api/changes/v1/conversations/get.md)

---

[API](https://skmtc.dev/ararahq/apis/ararahq-api.md) · [All operations](https://skmtc.dev/ararahq/apis/ararahq-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ararahq/ararahq-api/revisions/174c89e36a13/schema)