---
title: "Get Channel"
method: GET
path: "/apps/{app_id}/channels/{channel_id}"
---

# Get Channel

`GET /apps/{app_id}/channels/{channel_id}`

## Request

- Base URL: `https://api.xhostd.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.xhostd.com/apps/{app_id}/channels/{channel_id}`
- Auth: none declared

Report one channel of an app the caller can reach.

The route only reads, so it runs on ``run_read_in_thread``.
``load_channel_for`` reads the app, the membership row and the
channel in one statement; one more reads the pending deploy.

## Path parameters

- `app_id` string, uuid, required
- `channel_id` string, uuid, required

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- ChannelResponse
  - `id` string, uuid, required
  - `name` string, required
  - `hostname` string, required
  - `git_ref_binding` string, nullable, required
  - `follows_branch` boolean, required
  - `current_sha` string, nullable, required
  - `status` string, required
  - `pending_deploy` PendingDeployResponse, required: The channel's in-flight deploy, if one is queued or running.
    - `deploy_id` string, uuid, required
    - `sha` string, required
    - `status` string, required

## Other responses

- `422`: Validation Error

---

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