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

# List conversation views

> List all saved views for filtering conversations. Views are filter configurations created from the dashboard that can be used to filter conversations via the viewId parameter in the list conversations endpoint.



## OpenAPI

````yaml get /api/v2/conversations/views
openapi: 3.0.1
info:
  title: LiveChatAI API v2
  description: >-
    LiveChatAI API v2 - Build powerful AI-powered customer support experiences.
    This API follows REST principles with predictable, resource-oriented URLs,
    JSON responses, and standard HTTP methods.
  version: 2.0.0
servers:
  - url: https://app.livechatai.com
    description: Production server
security:
  - bearerAuth: []
paths:
  /api/v2/conversations/views:
    get:
      tags:
        - Conversations
      summary: List conversation views
      description: >-
        List all saved views for filtering conversations. Views are filter
        configurations created from the dashboard that can be used to filter
        conversations via the viewId parameter in the list conversations
        endpoint.
      parameters:
        - in: query
          name: agentId
          schema:
            type: string
            example: clx1234567890abcdef
          required: true
          description: Unique identifier of the agent/chatbot
        - in: query
          name: page
          schema:
            type: integer
            example: 1
            minimum: 1
          required: false
          description: 'Page number for pagination (default: 1)'
        - in: query
          name: perPage
          schema:
            type: integer
            example: 20
            minimum: 1
            maximum: 100
          required: false
          description: 'Number of inbox views per page (default: 20, max: 100)'
        - in: query
          name: search
          schema:
            type: string
            example: billing
          required: false
          description: Search inbox views by name
      responses:
        '200':
          description: Successfully retrieved inbox views list
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: success
                  data:
                    type: object
                    properties:
                      views:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              example: clx1234567890viewid
                              description: >-
                                View ID - use this with viewId parameter in list
                                conversations
                            name:
                              type: string
                              example: High Priority Negative
                              description: Name of the view
                            query:
                              type: object
                              description: Filter configuration for this view
                              properties:
                                combinator:
                                  type: string
                                  enum:
                                    - AND
                                    - OR
                                  example: AND
                                  description: Logic operator to combine rules
                                rules:
                                  type: array
                                  description: Filter rules or nested rule groups
                                  items:
                                    type: object
                                    properties:
                                      field:
                                        type: string
                                        example: sentiment
                                        description: >-
                                          Field to filter on (e.g., agentId,
                                          sentiment, topic, channel,
                                          resolutionStatus)
                                      operator:
                                        type: string
                                        example: EQUALS
                                        description: >-
                                          Comparison operator (EQUALS, NOT_EQUALS,
                                          CONTAINS, etc.)
                                      value:
                                        type: string
                                        example: NEGATIVE
                                        description: Value to compare against
                            createdAt:
                              type: string
                              format: date-time
                              example: '2024-01-15T10:30:00.000Z'
                              description: When the inbox view was created
                      meta:
                        type: object
                        properties:
                          total:
                            type: integer
                            example: 10
                            description: Total number of inbox views
                          perPage:
                            type: integer
                            example: 20
                            description: Number of records per page
                          currentPage:
                            type: integer
                            example: 1
                            description: Current page number
                          totalPages:
                            type: integer
                            example: 1
                            description: Total number of pages
        '400':
          description: Bad request - Missing agentId parameter
        '401':
          description: Unauthorized access
        '404':
          description: Chatbot not found or access denied
        '429':
          description: Rate limit exceeded - Too many requests to V2 API
        '500':
          description: Internal server error occurred
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````