> ## 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 AI Suggestions

> List AI suggestions for a specific agent. AI suggestions are automatically generated improvement suggestions based on conversations where the AI response may have been incomplete, out of context, or lacking depth.



## OpenAPI

````yaml get /api/v2/ai-suggestions
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/ai-suggestions:
    get:
      tags:
        - AI Suggestions
      summary: List AI Suggestions
      description: >-
        List AI suggestions for a specific agent. AI suggestions are
        automatically generated improvement suggestions based on conversations
        where the AI response may have been incomplete, out of context, or
        lacking depth.
      parameters:
        - in: query
          name: agentId
          schema:
            type: string
            example: clx1234567890abcdef
          required: true
          description: The unique identifier of the agent (chatbot)
        - in: query
          name: page
          schema:
            type: integer
            default: 1
            minimum: 1
          required: false
          description: Page number for pagination
        - in: query
          name: limit
          schema:
            type: integer
            default: 10
            minimum: 1
            maximum: 100
          required: false
          description: Number of items per page (max 100)
        - in: query
          name: startDate
          schema:
            type: string
            format: date-time
            example: '2024-01-01T00:00:00Z'
          required: false
          description: Filter suggestions created after this date (ISO 8601 format)
        - in: query
          name: endDate
          schema:
            type: string
            format: date-time
            example: '2024-12-31T23:59:59Z'
          required: false
          description: Filter suggestions created before this date (ISO 8601 format)
      responses:
        '200':
          description: Successfully retrieved AI suggestions
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: success
                  data:
                    type: object
                    properties:
                      agentId:
                        type: string
                        example: clx1234567890abcdef
                      suggestions:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              example: msg_abc123def456
                              description: >-
                                Unique identifier of the suggestion (AI message
                                ID)
                            userMessage:
                              type: object
                              properties:
                                id:
                                  type: string
                                  example: msg_user789xyz
                                text:
                                  type: string
                                  example: >-
                                    What is the warranty period for your
                                    products?
                            aiMessage:
                              type: object
                              properties:
                                id:
                                  type: string
                                  example: msg_abc123def456
                                text:
                                  type: string
                                  example: >-
                                    I'm sorry, I don't have information about
                                    that.
                            evaluationTag:
                              type: string
                              enum:
                                - OUT_OF_CONTEXT
                                - PARTIAL_ANSWER
                                - LACK_OF_DEPTH
                              example: OUT_OF_CONTEXT
                              description: >-
                                The type of issue identified with the AI
                                response
                            potentialGap:
                              type: string
                              nullable: true
                              example: >-
                                Warranty information is missing from the
                                knowledge base
                              description: Description of the potential knowledge gap
                            suggestedImprovement:
                              type: string
                              nullable: true
                              example: >-
                                All our products come with a 2-year warranty.
                                For details...
                              description: Suggested improvement for the response
                            chatId:
                              type: string
                              example: chat_xyz789
                              description: ID of the conversation
                            createdAt:
                              type: string
                              format: date-time
                              example: '2024-01-15T10:30:00Z'
                      pagination:
                        type: object
                        properties:
                          page:
                            type: integer
                            example: 1
                          limit:
                            type: integer
                            example: 10
                          totalCount:
                            type: integer
                            example: 25
                          totalPages:
                            type: integer
                            example: 3
                          hasNextPage:
                            type: boolean
                            example: true
                          hasPreviousPage:
                            type: boolean
                            example: false
        '400':
          description: Bad request - missing or invalid parameters
        '401':
          description: Unauthorized - invalid or missing API token
        '403':
          description: Forbidden - no access to this agent
        '429':
          description: Rate limit exceeded - Too many requests to V2 API
        '500':
          description: Internal server error
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````