---
title: "List channels"
method: GET
path: "/distchannels"
tags: ["Channels"]
---

# List channels

`GET /distchannels`

## Request

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

List channels for the authenticated user, optionally filtering by subscriber type and subsciber ID

## Query parameters

- `type` 'HUB'
- `subscriberId` string
- `includeReadOnly` boolean

## Response `200`

List of channels associated with the user, optionally filtered

- PagedDetailedChannels: A paginated array of channel details.
  - `items` DetailedChannel[], required
    - `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
  - `_links` Links
    - `next` Link
      - `href` string: An absolute URL linking to a resource.
    - `previous` Link
      - `href` string: An absolute URL linking to a resource.

## Changes

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

[Operation history](https://skmtc.dev/smartthings/apis/smartthings-api/changes/distchannels/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)