---
title: "Search the channels of one of those workspaces, in name order: every public channel and the private ones the Metricool app has been added to. Served from a copy refreshed from Slack every few hours."
method: GET
path: "/v2/settings/brands/{brand-id}/slack-connections/{connection-id}/channels"
tags: ["Brand Slack Destinations Api Service"]
---

# Search the channels of one of those workspaces, in name order: every public channel and the private ones the Metricool app has been added to. Served from a copy refreshed from Slack every few hours.

`GET /v2/settings/brands/{brand-id}/slack-connections/{connection-id}/channels`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/settings/brands/{brand-id}/slack-connections/{connection-id}/channels`
- Auth: none declared

## Path parameters

- `brand-id` integer, required
- `connection-id` integer, required

## Query parameters

- `q` string
- `page` integer
- `pageSize` integer

## Response `200`

Channels retrieved.

- JsonOkResponsePageDtoSlackChannelDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` PageDtoSlackChannelDto
    - `elements` SlackChannelDto[]
      - `id` string: Id Slack assigns to the channel.
      - `name` string: Name of the channel, without the #.
      - `privateChannel` boolean: Whether the channel is private. Only the private channels the app has been added to (/invite @Metricool) are listed.
    - `pageNumber` integer
    - `pageSize` integer
    - `totalElements` integer

## Other responses

- `400`: brand-id does not match the request blogId.
- `403`: Caller is not a regular-user session or lacks editBrand on the brand (a team member with manageBrands in its organization has it).
- `404`: The connection is not an active one of the brand's organization.
- `502`: slackUnavailable: Slack could not be read and there is no copy of the channels yet.
- `503`: slackChannelsSyncing: the copy of the channels is being built for the first time by another request; retry in a few seconds.

---

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