---
title: "List alert channels in enterprise"
method: GET
path: "/v1/enterprise/{enterprise_id}/alertchannels/"
tags: ["esper_cloud_api_Alerts"]
---

# List alert channels in enterprise

`GET /v1/enterprise/{enterprise_id}/alertchannels/`

⚠️ Android only. 

Returns a paginated list of all alert channels configured in the enterprise. Alert channels define the destinations where alert notifications are sent when alarm rules are triggered — currently supporting email as the delivery type. Use this endpoint to discover channel IDs for associating with alarm rules, or to audit existing notification destinations.

**Common use cases**

Retrieving channel IDs to associate with new or existing alarm rules

Auditing notification destinations across the enterprise

Verifying which alarm rules are linked to a given channel before updating or deleting it

**Best practices**

Check linked_alerts in the response before deleting a channel — removing a channel that is actively linked to alarm rules will affect those rules' notification delivery

Use the name filter to quickly locate a specific channel without paginating through all results

Note that id is an integer, not a UUID — use it as-is in subsequent calls to GET, PUT, PATCH, or DELETE on /alertchannels/{alert_id}

## Path parameters

- `enterprise_id` string, required

## Query parameters

- `name` string
- `limit` integer
- `offset` integer

## Response `200`

successful operation

- object
  - `count` integer, required
  - `next` string, url, nullable
  - `previous` string, url, nullable
  - `results` EsperCloudApiAlertChannelsV1[], required
    - `id` integer
    - `properties` object
      - `to_address` string, email
    - `name` string
    - `type` string — format of alert. e.g. email
    - `created_on` string, date-time
    - `updated_on` string, date-time
    - `enterprise` string, uuid
    - `linked_alerts` string[]

## Other responses

- `401` — Authorization information is missing or invalid.
- `404` — Not Found.
- `500` — Internal server error

---

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