---
title: "GET /spaces/{spaceId}/channels"
method: GET
path: "/spaces/{spaceId}/channels"
---

# GET /spaces/{spaceId}/channels

`GET /spaces/{spaceId}/channels`

Returns the list of channel within a private re:Post with some information about each channel.

## Path parameters

- `spaceId` string, required

## Query parameters

- `nextToken` string
- `maxResults` integer

## Response `200`

Success

- ListChannelsOutput
  - `channels` ChannelData[], required — An array of structures that contain some information about the channels in the private re:Post.
    - `spaceId` string, required — The unique ID of the private re:Post.
    - `channelId` string, required — The unique ID of the private re:Post channel.
    - `channelName` string, password, required — The name for the channel. This must be unique per private re:Post.
    - `channelDescription` string, password — A description for the channel. This is used only to help you identify this channel.
    - `createDateTime` string, date-time, required — The date when the channel was created.
    - `deleteDateTime` string, date-time — The date when the channel was deleted.
    - `channelStatus` 'CREATED' | 'CREATING' | 'CREATE_FAILED' | 'DELETED' | 'DELETING' | 'DELETE_FAILED', required — The status pf the channel.
    - `userCount` integer, required — The number of users that are part of the channel.
    - `groupCount` integer, required — The number of groups that are part of the channel.
  - `nextToken` string — The token that you use when you request the next set of channels.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — ThrottlingException
- `483` — InternalServerException

---

[API](https://skmtc.net/aws/apis/repostspace.md) · [All operations](https://skmtc.net/aws/apis/repostspace/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/repostspace/versions/1b4ca9ef5474/schema)