---
title: "List subscription channels"
method: GET
path: "/v1/subscription_channels"
tags: ["Subscription Center"]
---

# List subscription channels

`GET /v1/subscription_channels`

Returns a list of subscription channels available in your workspace. Channels represent the delivery methods that people can subscribe to or unsubscribe from—email, SMS, push, etc. If you haven't set up channel options in your subscription center, this endpoint returns an empty array.

## Response `200`

Returns an array of `channels`.

- object
  - `channels` object[]
    - `id` integer — The system-generated ID for the subscription channel.
    - `type` 'email' | 'twilio' | 'urban_airship' | 'slack' | 'push' | 'in_app' | 'line' | 'inbox' | 'whatsapp' — The type of delivery channel.
    - `name` string — The display name of the subscription channel.
    - `description` string — A description of the channel.
    - `subscribed_by_default` boolean — If false, a person is opted-out by default. If true, a person is opted-in by default.

## Other responses

- `429` — Your request is over the 10-per-second limit. `Retry-After` tells you how many seconds you must wait before you send the next request.

## Changes

- **2026-09-02** `5da2740beeb5` — 1 info
  - added the media type `application/json` for the response with the status `429`

[Change history](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/changes/v1/subscription_channels/get.md)

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) · [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customer/customer-io-journeys-api-reference/revisions/5da2740beeb5/schema)