---
title: "List all channels"
method: GET
path: "/v1/channels"
tags: ["v1Channels"]
---

# List all channels

`GET /v1/channels`

Lists the active channels of the workspace. Official WhatsApp channels have a non-null waba_id.

## Response `200`

- ChannelListPublicDto
  - `data` ChannelPublicDto[], required
    - `id` number, required
    - `description` string — Nome do canal. Para e-mail, é o endereço da caixa.
    - `platformId` number, required — 1 WhatsApp, 2 Telegram, 3 Facebook, 4 Widget, 5 E-mail, 6 Customizado, 7 Instagram, 8 Mercado Livre, 9 SMS
    - `phone` string
    - `status` string
    - `isConnected` boolean
    - `version` number — Versão do canal de WhatsApp: 3 não oficial, 4 oficial (Cloud API)
    - `waba_id` string — Id da WABA. Diferente de nulo apenas em canais de WhatsApp Oficial.
    - `groupIds` number[]
    - `isPrivate` boolean
    - `isBanned` boolean
    - `customFields` object
  - `totalCount` number, required

## Changes

- **2026-09-10** `a43da5bbb5f5` — 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/kinbox/apis/kinbox-api.md) · [All operations](https://skmtc.dev/kinbox/apis/kinbox-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kinbox/apis/kinbox-api/revisions/c083bbfe8973?raw)