---
title: "Buscar conexão por ID"
method: GET
path: "/v1/connections/{id}"
tags: ["Connections"]
---

# Buscar conexão por ID

`GET /v1/connections/{id}`

Retorna os dados de uma conexão específica do workspace.

## Path parameters

- `id` string, required

## Response `200`

Conexão retornada com sucesso

- ConnectionResponseDto
  - `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

- `400` — ID inválido — o parâmetro `id` não é um UUID válido
- `401` — Não autorizado — chave de empresa inválida ou ausente
- `404` — Conexão não encontrada para este workspace
- `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)