---
title: "Get a channel by ID"
method: GET
path: "/distchannels/{channelId}"
tags: ["Channels"]
---

# Get a channel by ID

`GET /distchannels/{channelId}`

## Request

- Base URL: `https://api.smartthings.com/v1`
- URL: `https://api.smartthings.com/v1/distchannels/{channelId}`
- Auth: OAuth 2
  - Implicit: `https://auth-global.api.smartthings.com`
  - Scopes: `r:channels:*`
- TypeScript: <https://skmtc.dev/smartthings/apis/smartthings-api/docs/distchannels/:channelId/get.ts> (a function with typed inputs; its response is checked against the schema)

Get channel details by channel ID

## Response `200`

Channel details

- DetailedChannel
  - `channelId` string, uuid: The identifier of the Sprocket channel
  - `name` string: Name of the channel
  - `description` string: Description of the channel
  - `type` 'DRIVER': The type of channel
  - `termsOfServiceUrl` string: URL for a developer-provided Terms of Service agreement for the channel
  - `createdDate` string: The ISO-8601 formatted timestamp when the channel was created
  - `lastModifiedDate` string: The ISO-8601 formatted timestamp when the channel was last modified

## Changes

- **2022-12-19** `adcacfc2749d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smartthings/apis/smartthings-api/changes/distchannels/:channelId/get.md)

---

[API](https://skmtc.dev/smartthings/apis/smartthings-api.md) - [All operations](https://skmtc.dev/smartthings/apis/smartthings-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smartthings/apis/smartthings-api/revisions/2788a4236800?raw)