> ## 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.

# Get Channel

> Retrieve details of a specific notification channel

## Path Parameters

<ParamField path="id" type="string" required>
  The notification channel ID
</ParamField>

## Response

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

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

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

<ResponseField name="config" type="object">
  Type-specific configuration (sensitive values are masked)
</ResponseField>

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

<ResponseField name="notify_on_incident" type="boolean">
  Whether to send notifications for incidents
</ResponseField>

<ResponseField name="notify_on_maintenance" type="boolean">
  Whether to send notifications for maintenance windows
</ResponseField>

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

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

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

<ResponseExample>
  ```json theme={null}
  {
    "id": "ch_abc123",
    "organization_id": "org_xyz",
    "type": "slack",
    "name": "Engineering Alerts",
    "config": {
      "webhook_url": "https://hooks.slack.com/servi..."
    },
    "enabled": true,
    "notify_on_incident": true,
    "notify_on_maintenance": true,
    "created_at": "2026-01-15T10:00:00.000Z",
    "updated_at": "2026-02-10T08:30:00.000Z"
  }
  ```
</ResponseExample>

<Note>
  Sensitive configuration values (webhook URLs, API tokens, secrets) are truncated or masked in the response. Full values are never returned after creation.
</Note>
