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

# List Notification Channels

> Get all configured notification channels

## Response

<ResponseField name="channels" type="array">
  <Expandable title="channel object">
    <ResponseField name="id" type="string">
      Channel ID
    </ResponseField>

    <ResponseField name="type" type="string">
      Channel type: `slack`, `webhook`, `discord`, `teams`, `pagerduty`, `sms`
    </ResponseField>

    <ResponseField name="name" type="string">
      Channel name
    </ResponseField>

    <ResponseField name="enabled" type="boolean">
      Whether channel is active
    </ResponseField>

    <ResponseField name="config" type="object">
      Channel-specific configuration
    </ResponseField>

    <ResponseField name="notify_on_incident" type="boolean">
      Whether to notify on incident events
    </ResponseField>

    <ResponseField name="notify_on_maintenance" type="boolean">
      Whether to notify on maintenance events
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://kodostatus.com/api/v1/notifications/channels" \
    -H "X-API-Key: your_api_key"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "channels": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "type": "slack",
        "name": "Engineering Alerts",
        "enabled": true,
        "config": { "webhook_url": "https://hooks.slack.com/..." },
        "notify_on_incident": true,
        "notify_on_maintenance": true,
        "created_at": "2026-01-15T10:30:00.000Z",
        "updated_at": "2026-01-15T10:30:00.000Z"
      },
      {
        "id": "660e8400-e29b-41d4-a716-446655440000",
        "type": "discord",
        "name": "Discord Alerts",
        "enabled": true,
        "config": { "webhook_url": "https://discord.com/api/webhooks/..." },
        "notify_on_incident": true,
        "notify_on_maintenance": false,
        "created_at": "2026-01-20T08:00:00.000Z",
        "updated_at": "2026-01-20T08:00:00.000Z"
      }
    ]
  }
  ```
</ResponseExample>