> ## Documentation Index
> Fetch the complete documentation index at: https://studio.assembly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a list of Message Channels

> Returns a paginated list of message channels the requester is a member of, optionally filtered by membership and enriched with unread state.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/message-channels
openapi: 3.0.0
info:
  contact: {}
  title: Assembly API
  version: 0.0.1
servers:
  - url: https://api.assembly.com
security: []
paths:
  /v1/message-channels:
    get:
      tags:
        - Message Channels
      summary: Get a list of Message Channels
      description: >-
        Returns a paginated list of message channels the requester is a member
        of, optionally filtered by membership and enriched with unread state.
      operationId: list-message-channels
      parameters:
        - description: Filter by client id. Alias for membershipEntityId.
          in: query
          name: clientId
          schema:
            type: string
        - description: Filter by the entity (company or client) the channel is scoped to.
          in: query
          name: membershipEntityId
          schema:
            type: string
        - description: >-
            Filter to channels scoped to this company. Combine with clientId to
            fetch the individual channel for a specific client/company pair.
          in: query
          name: companyId
          schema:
            type: string
        - description: >-
            Filter to channels containing this member id, and use it as the
            viewer for includeUnread enrichment.
          in: query
          name: memberId
          schema:
            type: string
        - description: Filter by channel membership type.
          in: query
          name: membershipType
          schema:
            enum:
              - company
              - individual
              - group
            type: string
        - description: Enrich each channel with unreadCount and lastRead for the viewer.
          in: query
          name: includeUnread
          schema:
            default: false
            type: boolean
        - description: Maximum number of records to return. Capped at 100.
          in: query
          name: limit
          schema:
            type: integer
        - description: Pagination cursor returned by a previous request.
          in: query
          name: nextToken
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api.List'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: >-
            Invalid pagination parameters, membership type, includeUnread value,
            or limit exceeded
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: Missing or invalid API key
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: Unexpected server error
      security:
        - APIKeyHeader: []
components:
  schemas:
    api.List:
      properties:
        data:
          items: {}
          nullable: true
          type: array
        nextToken:
          description: base64 encoded JSON representing a NextToken
          type: string
      type: object
    dispatcher.Error:
      properties:
        code:
          type: string
        data: {}
        message:
          type: string
      type: object
  securitySchemes:
    APIKeyHeader:
      in: header
      name: X-API-KEY
      type: apiKey

````