---
title: "List channel integrations"
method: GET
path: "/public/v1/channels"
tags: ["Agent Channels"]
---

# List channel integrations

`GET /public/v1/channels`

Returns the account's connected channel integrations (WhatsApp, Instagram, Messenger) and which agent each number/account/page is bound to. Connecting a channel requires the OAuth flow in the app and is not available via the API. Requires a USER API key.

## Response `200`

The account's channel integrations (null if none connected)

- PublicChannelIntegrations, nullable
  - `id` number, required
  - `accountId` number, required
  - `whatsapp` object, nullable, required
    - `id` number, required
    - `integrationId` number, required
    - `status` 'PENDING' | 'ACTIVE' | 'DELETED', required
    - `integratedById` number, required
    - `integratedBy` object, required
      - `firstName` string, required
      - `lastName` string, required
      - `avatar` string, nullable
    - `phoneNumbers` PublicWhatsAppNumber[], required
      - `id` number, required
      - `phoneNumberId` string, required
      - `assistantId` string, nullable, required
      - `assistant` object, nullable
        - `id` string, required
        - `name` string, required
      - `status` 'CONNECTED' | 'PENDING' | 'UNREGISTERED' | 'ERROR' | 'VERIFICATION_PENDING' | 'DELETED', required
      - `wabaId` string, required
      - `name` string, required
      - `about` string, nullable, required
      - `description` string, nullable, required
      - `address` string, nullable, required
      - `category` 'AUTO' | 'BEAUTY' | 'APPAREL' | 'EDU' | 'ENTERTAIN' | 'EVENT_PLAN' | 'FINANCE' | 'GROCERY' | 'GOVT' | 'HOTEL' | 'HEALTH' | 'NONPROFIT' | 'PROF_SERVICES' | 'RETAIL' | 'TRAVEL' | 'RESTAURANT' | 'OTHER' | 'UNDEFINED', required
      - `displayPhoneNumber` string, required
      - `website` string, nullable, required
      - `secondaryWebsite` string, nullable, required
      - `verificationStatus` 'VERIFIED' | 'NOT_VERIFIED', required
      - `image` string, nullable, required
      - `email` string, nullable, required
      - `createdAt` string, required
      - `updatedAt` string, required
    - `allocationId` string, nullable, required
    - `expirationTime` string, nullable
    - `createdAt` string, required
    - `updatedAt` string, required
  - `instagram` object, nullable, required
    - `id` number, required
    - `integrationId` number, required
    - `status` 'PENDING' | 'ACTIVE' | 'EXPIRED' | 'DELETED', required
    - `integratedById` number, required
    - `integratedBy` object, required
      - `firstName` string, required
      - `lastName` string, required
      - `avatar` string, nullable
    - `instagramAccounts` object[], required
      - `id` number, required
      - `instagramUserId` string, required
      - `username` string, required
      - `accountType` 'BUSINESS' | 'CREATOR', required
      - `profilePictureUrl` string, nullable, required
      - `followersCount` number, nullable, required
      - `mediaCount` number, nullable, required
      - `assistantId` string, nullable, required
      - `createdAt` string, required
      - `updatedAt` string, required
    - `tokenExpiresAt` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, required
  - `messenger` object, nullable, required
    - `id` number, required
    - `integrationId` number, required
    - `status` 'PENDING' | 'ACTIVE' | 'EXPIRED' | 'DELETED', required
    - `integratedById` number, required
    - `integratedBy` object, required
      - `firstName` string, required
      - `lastName` string, required
      - `avatar` string, nullable
    - `messengerPages` object[], required
      - `id` number, required
      - `messengerPageId` string, required
      - `businessAccountId` string, nullable, required
      - `pageName` string, required
      - `pageType` 'business', required
      - `pagePictureUrl` string, nullable, required
      - `followersCount` number, nullable, required
      - `likesCount` number, nullable, required
      - `assistantId` string, nullable, required
      - `createdAt` string, required
      - `updatedAt` string, required
    - `createdAt` string, required
    - `updatedAt` string, required

---

[API](https://skmtc.net/getfrontline/apis/public-api.md) · [All operations](https://skmtc.net/getfrontline/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getfrontline/public-api/revisions/9d33b6aad674/schema)