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

# List quality assessments

> Get a list of quality assessments with optional filters. Respects view permissions.



## OpenAPI

````yaml https://dev.enneo.dev/api/mind/docs/open-api get /quality/assessment
openapi: 3.0.0
info:
  version: '1'
  title: enneo.MIND API
  description: This describes the API of enneo Mind, the main ticketing backend
  contact:
    name: enneo GmbH
    email: richard@enneo.ai
  license:
    name: Proprietary software
    url: https://enneo.ai
servers:
  - url: https://demo.enneo.ai/api/mind
    description: Production server, demo client
  - url: https://main.enneo.dev/api/mind
    description: Development main branch
  - url: http://localhost:8005/api/mind
    description: Local development server
security:
  - bearerAuth:
      - api
  - cookieAuth:
      - api
paths:
  /quality/assessment:
    get:
      tags:
        - Quality Management
      summary: List quality assessments
      description: >-
        Get a list of quality assessments with optional filters. Respects view
        permissions.
      operationId: listQualityAssessments
      parameters:
        - name: state
          in: query
          description: >
            Filter by assessment workflow state (comma-separated list). Allowed
            values: unprocessed, aiInProgress, aiReady, reviewOngoing,
            reviewedBySupervisor, discussedWithAssessee, error.
          required: false
          schema:
            type: string
            example: aiReady,reviewOngoing
        - name: user
          in: query
          description: Filter by assessed user ID
          required: false
          schema:
            type: integer
            example: 42
        - name: from
          in: query
          description: Inclusive start date (`YYYY-MM-DD`) — filters by `createdAt`.
          required: false
          schema:
            type: string
            format: date
            example: '2024-06-01'
        - name: to
          in: query
          description: >-
            Inclusive end date (`YYYY-MM-DD`) — filters by `createdAt`,
            end-of-day.
          required: false
          schema:
            type: string
            format: date
            example: '2024-06-30'
        - name: ticketId
          in: query
          description: Filter by ticket ID.
          required: false
          schema:
            type: integer
            example: 8821
        - name: limit
          in: query
          description: Maximum number of assessments to return.
          required: false
          schema:
            type: integer
            default: 100
            example: 100
        - name: offset
          in: query
          description: Number of assessments to skip (for pagination).
          required: false
          schema:
            type: integer
            default: 0
            example: 0
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  assessments:
                    type: array
                    items:
                      $ref: '#/components/schemas/QualityAssessment'
              examples:
                default:
                  summary: Summaries matching filters and permissions
                  value:
                    assessments:
                      - id: 901
                        scorecardId: 42
                        scorecardBaseId: 17
                        state: reviewOngoing
                        assessedUser: 23
                        assessedByUser: null
                        ticketId: 8821
                        worklogId: 551
                        createdAt: '2024-06-12T10:20:00Z'
                        modifiedAt: '2024-06-12T10:45:00Z'
                        canEdit: true
                        aiSummary: AI summary of the conversation...
                        totals:
                          scoredPoints: 18
                          usedMaxPoints: 20
                          totalMaxPoints: 25
                          percentage: 72
                        worklog:
                          userId: 23
                          worklogId: 551
                          lastInteraction: '2024-06-12T09:59:00Z'
                          ticketId: 8821
                          conversationId: 331
                          action: reply
                          actionList:
                            - reply
                            - internal-note
                        aiUsage:
                          automationLevel: 2
                          automationLevelLabel: Assisted
                          aiAgents: []
                        time:
                          duration: 480
                          durationAfterWork: 120
                          segments: []
                        customerExperience:
                          slaMet: true
                          netSecondsClosedAfterSla: -30
                          closingDateForSLA: '2024-06-12T09:40:00Z'
                          dueDateForSLA: '2024-06-12T10:00:00Z'
                          reOpened: false
                          csat: null
        '403':
          description: Unauthorized
        '500':
          description: Internal error
components:
  schemas:
    QualityAssessment:
      type: object
      description: Quality assessment of agent performance on a specific work session
      properties:
        id:
          type: integer
          description: Assessment ID
          example: 1
        scorecardId:
          type: integer
          description: ID of the scorecard used
          example: 1
        scorecardBaseId:
          type: integer
          description: Base ID of the scorecard used
          example: 1
        state:
          type: string
          enum:
            - unprocessed
            - aiInProgress
            - aiReady
            - reviewOngoing
            - reviewedBySupervisor
            - discussedWithAssessee
            - error
            - deleted
          description: Assessment workflow state
          example: aiReady
        assessedUser:
          type: integer
          description: ID of the assessed user (agent)
          example: 42
        assessedByUser:
          type: integer
          nullable: true
          description: ID of the supervisor who assessed
        ticketId:
          type: integer
          description: Related ticket ID
          example: 12345
        worklogId:
          type: integer
          nullable: true
          description: Related worklog ID
        aiSummary:
          type: string
          description: AI-generated summary (summary format)
          example: Good job overall, scored 85%
        totals:
          type: object
          description: Score totals
          properties:
            scoredPoints:
              type: integer
              description: Points achieved
              example: 24
            usedMaxPoints:
              type: integer
              description: Maximum points for scored criteria
              example: 32
            totalMaxPoints:
              type: integer
              description: Maximum points for all criteria
              example: 47
            percentage:
              type: number
              description: Percentage score
              example: 75
        data:
          type: object
          description: Full assessment data (full format only)
          properties:
            aiSummary:
              type: string
            general:
              type: object
              description: Work session metadata
              additionalProperties: true
            aiUsage:
              type: object
              description: AI automation metrics
              additionalProperties: true
            time:
              type: object
              description: Time tracking information
              additionalProperties: true
            customerExperience:
              type: object
              description: Customer satisfaction metrics
              additionalProperties: true
            categories:
              type: array
              description: Scored categories and criteria
              items:
                type: object
                additionalProperties: true
            totals:
              type: object
              additionalProperties: true
            supervisorAssessment:
              type: string
              nullable: true
            assessmentDate:
              type: string
              format: date-time
              nullable: true
            discussionDate:
              type: string
              format: date-time
              nullable: true
        createdAt:
          type: string
          format: date-time
        modifiedAt:
          type: string
          format: date-time
        canEdit:
          type: boolean
          description: Whether current user can edit this assessment
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT-based authentication
      x-scopes:
        api: Full access to the API
    cookieAuth:
      type: apiKey
      in: cookie
      name: connect.sid
      description: Cookie-based authentication
      x-scopes:
        api: Full access to the API

````