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

# List Organization Channels

`GET /slack/channels`

Return Slack channels for the caller's organization, optionally name-filtered.

## Query parameters

- `query` string, nullable — Case-insensitive substring match on channel_name for typeahead. Results are ranked by relevance: exact, then prefix, then substring.
- `prefix` string, nullable — Deprecated alias for `query`; use `query` instead.
- `limit` integer — Maximum number of channels to return.

## Response `200`

Successful Response

- ListOrganizationSlackChannelsResponse — Response model for listing the caller's organization's Slack channels.
  - `channels` SlackChannelSummary[], required
    - `channel_id` string, required
    - `channel_name` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/traversal/apis/fastapi.md) · [All operations](https://skmtc.net/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/traversal/fastapi/revisions/2134ebffd1ef/schema)