---
title: "Consultar conversas / contatos"
method: GET
path: "/v1/contacts"
tags: ["Contacts"]
---

# Consultar conversas / contatos

`GET /v1/contacts`

Lista conversas individuais do workspace.

## Query parameters

- `number` string
- `connection` string
- `id` string, uuid
- `createdAfter` string
- `createdBefore` string
- `modifiedAfter` string
- `modifiedBefore` string
- `status` string
- `stage` 'Open' | 'Closed' | 'Pending'
- `hasUnread` boolean
- `department` string
- `tags` string
- `page` number
- `limit` number

## Response `200`

Lista de conversas retornada com sucesso

- ChatsListResponseDto
  - `contacts` ChatResponseDto[], required
    - `id` string, uuid, required — UUID do chat/contato (`Chat.id`)
    - `contactNumber` string, required — Contact phone number
    - `contactName` string, nullable — Contact name
    - `department` string, uuid, nullable — Department ID
    - `status` string, uuid, nullable — Status label ID
    - `source` string, uuid, nullable — Source label ID
    - `connection` string, uuid, nullable — Connection ID
    - `agent` string, uuid, nullable — AI agent ID
    - `user` string, uuid, nullable — Human agent (company user) ID
    - `ticketStatus` 'open' | 'closed' | 'pending', nullable — Ticket status
    - `createdAt` string, date-time, nullable — Chat creation date (ISO string)
    - `integration` 'WHATSAPP-NON-OFFICIAL' | 'WHATSAPP-BUSINESS', required — Normalized integration type
    - `lastInteraction` string, date-time, nullable — Last interaction date (ISO string). Returned only for official integrations.
    - `isWhatsAppWindowClosed` boolean, nullable — True when WhatsApp conversation window is closed. Returned only for official integrations.
    - `tags` string[], nullable — Tags array
  - `pagination` ChatsPaginationDto, required
    - `page` number, required
    - `limit` number, required
    - `total` number, required
    - `totalPages` number, required
    - `hasNextPage` boolean, required
    - `hasPreviousPage` boolean, required

## Other responses

- `400` — Requisição inválida — filtros mal formatados
- `401` — Não autorizado — chave de empresa inválida ou ausente

---

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