---
title: "List Channels"
method: GET
path: "/api/v1/notifications/channels"
tags: ["channels"]
---

# List Channels

`GET /api/v1/notifications/channels`

List account-level notification channels.

Returns all channel configurations for the account (workflow_id=None scope).
channel_type is required - no cross-type aggregation.

## Query parameters

- `channel_type` 'webhook' | 'email', required — Notification delivery channel types.
- `enabled` boolean, nullable

## Headers

- `unstructured-api-key` string, nullable

## Response `200`

Successful Response

- ChannelListResponse — List response for notification channels (no pagination, max 50 per scope).
  - `items` union[], required — List of channels
    - union
      - WebhookChannelResponse — Response for webhook notification channel.
        - `channel_type` 'webhook'
        - `id` string, required — Channel ID
        - `description` string, nullable — Channel description
        - `event_types` string[], required — Subscribed event types
        - `enabled` boolean, required — Channel enabled status
        - `created_at` string, date-time, required — Creation timestamp
        - `updated_at` string, date-time, required — Last update timestamp
        - `url` string, required — Webhook endpoint URL
      - EmailChannelResponse — Response for email notification channel.
        - `channel_type` 'email'
        - `id` string, required — Channel ID
        - `description` string, nullable — Channel description
        - `event_types` string[], required — Subscribed event types
        - `enabled` boolean, required — Channel enabled status
        - `created_at` string, date-time, required — Creation timestamp
        - `updated_at` string, date-time, required — Last update timestamp
        - `email_config` EmailChannelConfigResponse, required — Email config in response (no sensitive data).
          - `cc` string[], nullable — CC email addresses (if provider supports)
          - `reply_to` string, email, nullable — Reply-to email address
          - `recipient_email` string, email, required — Primary recipient email address
          - `provider` string, required — Email provider (read-only, from platform config)

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/unstructuredapp/apis/platform-api.md) · [All operations](https://skmtc.net/unstructuredapp/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unstructuredapp/platform-api/revisions/41676641a27c/schema)