---
title: "List"
method: GET
path: "/alerts_channels.json"
tags: ["Deprecation Notice - Alerts Channels"]
---

# List

`GET /alerts_channels.json`

## Request

- Base URL: `https://api.newrelic.com/v2`
- URL: `https://api.newrelic.com/v2/alerts_channels.json`
- Auth: API key in header `Api-Key`
- TypeScript: <https://skmtc.dev/newrelic/apis/new-relic-rest-api-v2/docs/alerts_channels.json/get.ts> (a function with typed inputs; its response is checked against the schema)

<strong>🔥 This endpoint will be deprecated after 2024/01 🔥</strong> New users should use <a href="https://docs.newrelic.com/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/alerts-nerdgraph/nerdgraph-api-examples/">these docs about managing alerts via NerdGraph.</a>

<hr>

<p>This API endpoint works with new Alerts on alerts.newrelic.com.</p>

<p>It returns a list of the channels associated with your New Relic account.</p>

<p>Note: See our documentation for a discussion on <a href="https://docs.newrelic.com/docs/alerts/new-relic-alerts/rest-api-alerts/rest-api-calls-new-relic-alerts#channels-list">listing notification channels</a>.</p>

## Query parameters

- `page` integer

## Response `200`

No response was specified

- ChannelResponse
  - `channel` ChannelResponseType
    - `configuration` object
    - `id` integer
    - `links` ChannelLinksResponse
      - `policy_ids` integer[]
    - `name` string
    - `type` string

---

[API](https://skmtc.dev/newrelic/apis/new-relic-rest-api-v2.md) - [All operations](https://skmtc.dev/newrelic/apis/new-relic-rest-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/newrelic/apis/new-relic-rest-api-v2/revisions/cf1843ad0a45?raw)