---
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)

---

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