---
title: "Read channel configuration and saved readiness"
method: GET
path: "/channels/{channelId}"
tags: ["Channels"]
---

# Read channel configuration and saved readiness

`GET /channels/{channelId}`

## Request

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

Use a channel.id from list_channels or channelIds from a completed connection attempt. Inspect active/respondEnabled, provider type, activation state, token status, expiry and saved degraded codes/timestamps before changing configuration. These are saved signals, not a fresh provider probe. For live WhatsApp diagnostics use get_whatsapp_channel_health; for installation use get_webchat_channel_setup. No provider credentials or raw provider error text are returned. Requires `channels:read`.

## Path parameters

- `channelId` string, required

## Response `200`

Read channel configuration and saved readiness

- ChannelDetailResponse
  - `channel` Channel, required: Saved channel configuration and readiness signals. Active/respondEnabled do not prove provider readiness or message delivery. Error codes are safe diagnostics; raw provider error text and credentials are omitted.
    - `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

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