> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pingback.live/llms.txt
> Use this file to discover all available pages before exploring further.

# List Channels

> Retrieve all channels configured for your business.

Returns an array of all channels associated with your business, including both active and inactive ones.

**Method**: `GET`  **URL**: `/api/v1/channels/`

### Headers

| Header        | Value          |
| ------------- | -------------- |
| Authorization | Bearer {token} |

### Response

<ResponseField name="id" type="string" required>
  Unique identifier for the channel (UUID).
</ResponseField>

<ResponseField name="business_id" type="string" required>
  UUID of the business that owns this channel.
</ResponseField>

<ResponseField name="type" type="string" required>
  The channel type. One of: `webchat`, `widget`, `email`, `whatsapp`, `telegram`, `instagram`, `x`, `sms`.
</ResponseField>

<ResponseField name="config" type="object" required>
  Channel-specific configuration object. Contents vary by channel type (see [Create Channel](/api-reference/channels/create) for details).
</ResponseField>

<ResponseField name="is_active" type="boolean" required>
  Whether the channel is currently active.
</ResponseField>

<ResponseField name="created_at" type="string" required>
  ISO 8601 timestamp of when the channel was created.
</ResponseField>

### Example

<CodeGroup>
  ```bash curl theme={null}
  curl --request GET \
    --url https://api.pingback.live/api/v1/channels/ \
    --header 'Authorization: Bearer {token}'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.pingback.live/api/v1/channels/', {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer {token}'
    }
  });

  const channels = await response.json();
  ```
</CodeGroup>

### Response example

```json theme={null}
[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "business_id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
    "type": "whatsapp",
    "config": {
      "phone_number_id": "1234567890",
      "access_token": "EAAxxxxxxx",
      "verify_token": "my_verify_token"
    },
    "is_active": true,
    "created_at": "2024-01-15T10:30:00Z"
  },
  {
    "id": "7cb96e12-3a4b-4c5d-8e9f-0a1b2c3d4e5f",
    "business_id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
    "type": "widget",
    "config": {
      "widget_id": "9d8e7f6a-5b4c-3d2e-1f0a-9b8c7d6e5f4a"
    },
    "is_active": true,
    "created_at": "2024-01-10T08:00:00Z"
  }
]
```

### Errors

| Status | Meaning                                 |
| ------ | --------------------------------------- |
| 401    | Unauthorized — missing or invalid token |