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

# List channels

`GET /v1/channels`

## Request

- Base URL: `https://api.merlonix.com`
- URL: `https://api.merlonix.com/v1/channels`
- Auth: HTTP bearer

All alert notification channels configured for the tenant.

## Response `200`

All channels.

- object
  - `data` Channel[], required
    - `id` string, uuid, required
    - `tenant_id` string, uuid, required
    - `kind` 'email' | 'slack_webhook' | 'generic_webhook' | 'teams_webhook' | 'discord_webhook' | 'telegram' | 'google_chat' | 'pagerduty' | 'opsgenie' | 'sms', required
    - `name` string, required
    - `target` string, required: Destination; shape depends on kind (email / webhook URL / token:chat / routing key / E.164).
    - `signing_secret_preview` string, nullable, required: First 6 chars of the webhook signing secret; null for email + slack channels.
    - `is_active` boolean, required
    - `severity_filter` string[], required
    - `created_at` string, date-time, required
    - `last_delivery` object, nullable, required: TD-1220: most-recent alert delivery to this channel; null when none.
      - `status` string
      - `at` string, date-time
      - `error_message` string, nullable

## Other responses

- `401`: Error — canonical envelope with a trace_id.
- `429`: Error — canonical envelope with a trace_id.

---

[API](https://skmtc.dev/merlonix/apis/merlonix-public-api.md) · [All operations](https://skmtc.dev/merlonix/apis/merlonix-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/merlonix/apis/merlonix-public-api/revisions/2192584bdfcd?raw)