# Get channel by ID (https://developer.godaddy.com/en/docs/references/rest/channels/get-channel-by-id)

---
title: Get channel by ID
description: Returns a single channel by ID.
full: true
---

Full description

Returns a single channel by ID. Access requires a service principal in GLOBAL or channel-scoped customer permissions. Authorization is checked before existence; an unknown channelId might return 401 instead of 404.

## GET /channels/{channelId}

Get channel by ID

Returns a single channel by ID. Access requires a service principal in GLOBAL or channel-scoped customer permissions. Authorization is checked before existence; an unknown channelId might return 401 instead of 404.

### Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `channelId` | unknown | yes |  |

### Responses

**200** — Channel Found

Content-Type: `application/json`

Schema:

- schema reference: `#/x-ext/df5646b`

**401** — Authentication failed or missing.

Content-Type: `application/json`

Schema:

- schema reference: `#/x-ext/e2dac50`

**403** — Caller is authenticated but not authorized for this action.

Content-Type: `application/json`

Schema:

- schema reference: `#/x-ext/e2dac50`

**404** — The requested resource was not found.

Content-Type: `application/json`

Schema:

- schema reference: `#/x-ext/e2dac50`

**500** — Unexpected server error.

Content-Type: `application/json`

Schema:

- schema reference: `#/x-ext/e2dac50`

**Security:** requires `PAT`; scopes `commerce.channel:read`.