---
title: "List tenant channels"
method: GET
path: "/channels"
tags: ["Channels"]
---

# List tenant channels

`GET /channels`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/channels`
- Auth: HTTP bearer

Use first to discover saved channel.id, provider/type, active/respondEnabled and saved readiness/version fields for the connected business. Use the stored id for channel tools; provider phone/page/WABA IDs are separate identifiers. Read get_channel for detail, get_whatsapp_channel_health for live Meta checks, and get_channel_connection_options before adding a channel. Listing does not create a webchat channel, prove OAuth readiness or message delivery. Requires `channels:read`.

## Response `200`

Tenant channels

- ChannelsResponse
  - `channels` Channel[], required
    - `id` string, required
    - `tenantId` string, required
    - `propertyId` string
    - `propertyIds` string[], required
    - `provider` 'meta' | 'native' | 'tiktok', required
    - `type` 'whatsapp' | 'instagram' | 'messenger' | 'webchat' | 'tiktok', required
    - `name` string
    - `active` boolean, required
    - `respondEnabled` boolean, required
    - `degraded` boolean, required
    - `identifiers` object, required
      - `phoneNumberId` string
      - `phoneNumber` string
      - `wabaId` string
      - `igAccountId` string
      - `pageId` string
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `externalId` string
    - `appId` string
    - `metaAppKey` string
    - `igGraphApi` string
    - `waConnectionMode` string
    - `waActivationStatus` string
    - `tokenStatus` string
    - `tokenRefreshErrorCode` string
    - `degradedCode` string
    - `degradedByService` string
    - `expiresAt` string, date-time
    - `tokenLastRefreshedAt` string, date-time
    - `tokenRefreshErrorAt` string, date-time
    - `degradedAt` string, date-time
    - `degradedWindowStartedAt` string, date-time
    - `degradedLastErrorAt` string, date-time
    - `waActivationUpdatedAt` string, date-time
    - `degradedSignalCount` integer
    - `instagramResponsePolicy` object
      - `storyMentions` boolean, required
      - `storyReplies` boolean, required
  - `tiktokAvailable` boolean

## Other responses

- `default`: Structured error

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)