---
title: "Listar conexões WhatsApp"
method: GET
path: "/v1/connections"
tags: ["Connections"]
---

# Listar conexões WhatsApp

`GET /v1/connections`

Retorna todas as conexões WhatsApp do workspace, incluindo status de cada uma.

## Response `200`

Lista de conexões retornada com sucesso

- ConnectionsListResponseDto
  - `connections` ConnectionResponseDto[], required
    - `id` string, uuid, required — Connection unique identifier
    - `number` object — WhatsApp phone number
    - `connectionStatus` string, required — Connection status
    - `agent` object — Default agent ID (`Agent.id`)
    - `department` object — Department ID
    - `status` object — Status label ID
    - `integration` 'WHATSAPP-BUSINESS' | 'WHATSAPP-NON-OFFICIAL', required — Normalized integration type

## Other responses

- `401` — Não autorizado — chave de empresa inválida ou ausente
- `500` — Erro interno ao consultar o banco (ex.: indisponibilidade do serviço de dados)

---

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