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

# List conversations

> Returns a paginated list of conversations for the authenticated user. Can be filtered by status (normal, unread, archived), keyword (title or participant name), or exact participant set. Supports pagination via limit and page.



## OpenAPI

````yaml /openapi.yaml get /conversations
openapi: 3.0.0
info:
  title: Ziik API
  version: '1.0'
servers: []
security: []
tags:
  - name: Auth
    description: Auth
  - name: Posts
    description: Posts
  - name: Counters
    description: Counters
  - name: Groups
    description: Groups
  - name: Languages
    description: Languages
  - name: Timezones
    description: Timezones
  - name: Units
    description: Units
  - name: User unit memberships
    description: User unit memberships
  - name: Users
    description: Users
  - name: User types
    description: User types
  - name: Conversations
    description: Conversations
paths:
  /conversations:
    get:
      tags:
        - Conversations
      summary: List conversations
      description: >-
        Returns a paginated list of conversations for the authenticated user.
        Can be filtered by status (normal, unread, archived), keyword (title or
        participant name), or exact participant set. Supports pagination via
        limit and page.
      operationId: 9ce45b2887011980f3b9dc92fec9830e
      parameters:
        - name: status
          in: query
          description: Filter by conversation status
          required: false
          schema:
            type: string
            enum:
              - normal
              - archived
              - unread
        - name: keyword
          in: query
          description: Search in conversation title or participant names
          required: false
          schema:
            type: string
        - name: participants
          in: query
          description: >-
            Filter by exact set of participant user IDs (finds or excludes
            conversations with exactly these users)
          required: false
          schema:
            type: array
            items:
              type: integer
        - name: limit
          in: query
          description: Number of items per page (1–100)
          required: false
          schema:
            type: integer
            default: 10
        - name: page
          in: query
          description: Page number for pagination
          required: false
          schema:
            type: integer
      responses:
        '200':
          description: Paginated list of conversations.
          content:
            application/json:
              schema:
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Conversation'
                type: object
components:
  schemas:
    Conversation:
      properties:
        id:
          type: integer
          example: 1
        type:
          description: 'Conversation type: direct or group'
          type: string
          example: direct
        title:
          description: Conversation title (group only)
          type: string
          example: ''
        created_at:
          description: Unix timestamp
          type: integer
          format: int64
        updated_at:
          description: Unix timestamp
          type: integer
          format: int64
        latest_message:
          description: Latest message in the conversation
          type: object
          nullable: true
        mute_rule:
          description: Mute rule ID or null
          type: integer
          nullable: true
        unread_message_count:
          type: integer
          example: 0
        participants:
          description: Conversation participants
          type: array
          items:
            $ref: '#/components/schemas/BasicUser'
        publish:
          properties:
            created_at:
              type: integer
              format: int64
            updated_at:
              type: integer
              format: int64
          type: object
        archived_at:
          description: When the auth user archived this conversation
          type: integer
          format: int64
          nullable: true
      type: object
    BasicUser:
      properties:
        id:
          type: integer
          example: 1
        first_name:
          type: string
          example: John
        last_name:
          type: string
          example: Doe
        name:
          type: string
          example: John Doe
        title:
          type: string
          example: Manager
        active:
          type: boolean
          example: true
        avatar:
          description: Avatar image or null
          type: object
          nullable: true
        archived_at:
          description: Conversation participant archived timestamp or null
          type: integer
          format: int64
          nullable: true
        participant_type:
          description: Conversation participant type when present
          type: string
          nullable: true
        subtext:
          description: Short descriptive text combining title/unit/department
          type: string
          example: Manager - HQ (Sales)
        department:
          properties:
            id:
              type: integer
              example: 10
            name:
              type: string
              example: Sales
          type: object
          nullable: true
        unit:
          properties:
            id:
              type: integer
              example: 5
            name:
              type: string
              example: HQ
          type: object
          nullable: true
      type: object

````