---
title: "List channels for one app."
method: GET
path: "/channel/"
tags: ["channels"]
---

# List channels for one app.

`GET /channel/`

## Request

- Base URL: `https://api.capgo.app`
- URL: `https://api.capgo.app/channel/`
- Auth: API key in header `x-api-key`

List live-update channels for one app, including the current bundle assignment and rollout flags.

## Query parameters

- `app_id` string, required
- `page` integer
- `channel` string

## Response `200`

Channels.

- ChannelListEnvelope
  - `data` Channel[], required
    - `id` integer, required
    - `name` string, required
    - `app_id` string, required
    - `version` ChannelVersion
      - `id` integer, required
      - `name` string, required
    - `public` boolean
    - `disableAutoUpdateUnderNative` boolean
    - `disableAutoUpdate` union
      - string
      - boolean
    - `allow_emulator` boolean
    - `allow_dev` boolean
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401`: The API key is missing, invalid, or expired.
- `403`: The API key is valid but lacks the required scope or org access.
- `429`: Too many requests. Back off and retry later.
- `500`: Unexpected Capgo server error.

---

[API](https://skmtc.dev/capgo/apis/capgo-public-api.md) · [All operations](https://skmtc.dev/capgo/apis/capgo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/capgo/apis/capgo-public-api/revisions/8496acb7a95b?raw)