---
title: Lister les canaux
openapi: /openapi/firmreader.yaml GET /channels
lastUpdated: "2026-08-17"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

`GET https://api.firmreader.com/v1/channels`

Retrieve all channels in the workspace that the API key has access to.

## Authentication

- `bearerAuth` — http bearer (API Key)

## Query parameters

- `visibility` (string) — Filter by visibility level.
- `limit` (integer) — Number of channels to return per page.
- `cursor` (string) — Cursor for pagination.

## Response 200

List of channels
  - response (object)
    - `data` (array)
      - `items` (object)
        - `id` (string) — Unique channel identifier.
        - `name` (string) — Display name of the channel.
        - `slug` (string) — URL-friendly identifier.
        - `description` (string) — Short summary of the channel.
        - `visibility` (string, one of: organization, team, private) — Who can see this channel.
        - `subscriber_count` (integer) — Number of subscribers.
        - `post_count` (integer) — Total posts in the channel.
        - `is_default` (boolean) — Whether new members are auto-subscribed.
        - `is_archived` (boolean) — Whether the channel is archived.
        - `created_at` (string, date-time)
        - `updated_at` (string, date-time)
    - `next_cursor` (string)
    - `has_more` (boolean)

## Response 401

Unauthorized
  - response (object)
    - `error` (object)
      - `code` (string) — Machine-readable error code.
      - `message` (string) — Human-readable error message.
      - `param` (string) — The parameter that caused the error, if applicable.


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://docs.firmreader.com/api-specs.zip