> ## 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.

# Export quality assessments

> Export quality assessments with all criterion scores for a given scorecard.

Each row represents one assessment with the following columns:
- Date (createdAt - when the assessment was created)
- Assessment Date (when the supervisor completed the assessment, null for AI-only assessments)
- Reviewed Agent (name of the assessed user)
- Reviewer (name of the reviewer or "AI" for AI-generated assessments)
- State (translated to readable labels: "Ready for Review", "Reviewed", etc.)
- Ticket ID
- Total Score (absolute scored points as integer)
- Total Score (%) (percentage score)
- One column per criterion score (e.g., "Communication Quality - Clarity & Readability")

**Default Scorecard Behavior:**
If `scorecardId` is omitted, the scorecard from the most recent valid assessment is used as default.

**Multi-Sheet XLSX Export:**
When format is `xlsx` and `scorecardId` is omitted, the export generates one Excel sheet per scorecard
that has assessments. Each sheet is named after the scorecard.

**Excluded States:**
Assessments in states `unprocessed`, `aiInProgress`, `deleted`, and `error` are excluded from the export.

Example requests:
```
GET /api/mind/export/qualityAssessments?format=json
GET /api/mind/export/qualityAssessments?format=xlsx&scorecardId=1
GET /api/mind/export/qualityAssessments?format=xlsx&from=2024-01-01&to=2024-12-31
```




## OpenAPI

````yaml https://dev.enneo.dev/api/mind/docs/open-api get /export/qualityAssessments
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:
  /export/qualityAssessments:
    get:
      tags:
        - Export
      summary: Export quality assessments
      description: >
        Export quality assessments with all criterion scores for a given
        scorecard.


        Each row represents one assessment with the following columns:

        - Date (createdAt - when the assessment was created)

        - Assessment Date (when the supervisor completed the assessment, null
        for AI-only assessments)

        - Reviewed Agent (name of the assessed user)

        - Reviewer (name of the reviewer or "AI" for AI-generated assessments)

        - State (translated to readable labels: "Ready for Review", "Reviewed",
        etc.)

        - Ticket ID

        - Total Score (absolute scored points as integer)

        - Total Score (%) (percentage score)

        - One column per criterion score (e.g., "Communication Quality - Clarity
        & Readability")


        **Default Scorecard Behavior:**

        If `scorecardId` is omitted, the scorecard from the most recent valid
        assessment is used as default.


        **Multi-Sheet XLSX Export:**

        When format is `xlsx` and `scorecardId` is omitted, the export generates
        one Excel sheet per scorecard

        that has assessments. Each sheet is named after the scorecard.


        **Excluded States:**

        Assessments in states `unprocessed`, `aiInProgress`, `deleted`, and
        `error` are excluded from the export.


        Example requests:

        ```

        GET /api/mind/export/qualityAssessments?format=json

        GET /api/mind/export/qualityAssessments?format=xlsx&scorecardId=1

        GET
        /api/mind/export/qualityAssessments?format=xlsx&from=2024-01-01&to=2024-12-31

        ```
      operationId: exportQualityAssessments
      parameters:
        - name: format
          in: query
          required: false
          description: >-
            Export format. Defaults to the backend `defaultDateExportFormat`
            setting.
          schema:
            type: string
            enum:
              - xlsx
              - csv
              - json
            default: xlsx
          example: xlsx
        - name: scorecardId
          in: query
          required: false
          description: >
            ID of the scorecard to export assessments for. If omitted:

            - For XLSX format: exports all scorecards as separate sheets

            - For other formats: uses the scorecard from the most recent valid
            assessment
          schema:
            type: integer
          example: 1
        - name: from
          in: query
          required: false
          description: >-
            Start date filter (inclusive). Only assessments created on or after
            this date are included.
          schema:
            type: string
            format: date
          example: '2024-01-01'
        - name: to
          in: query
          required: false
          description: >-
            End date filter (inclusive). Only assessments created on or before
            this date are included.
          schema:
            type: string
            format: date
          example: '2024-12-31'
        - $ref: '#/components/parameters/limitParam'
        - $ref: '#/components/parameters/offsetParam'
      responses:
        '200':
          description: Export returned successfully.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    Date:
                      type: string
                      format: date-time
                      description: When the assessment was created
                    Assessment Date:
                      type: string
                      format: date-time
                      nullable: true
                      description: >-
                        When the supervisor completed the assessment (null for
                        AI-only assessments)
                    Reviewed Agent:
                      type: string
                      description: Name of the agent whose work was assessed
                    Reviewer:
                      type: string
                      description: >-
                        Name of the reviewer or "AI" for AI-generated
                        assessments
                    State:
                      type: string
                      description: Human-readable assessment state
                      enum:
                        - Ready for Review
                        - Review in Progress
                        - Reviewed
                        - Discussed with Agent
                    Ticket ID:
                      type: integer
                      description: ID of the ticket that was assessed
                    Total Score:
                      type: integer
                      nullable: true
                      description: Absolute scored points
                    Total Score (%):
                      type: number
                      format: float
                      description: Overall assessment score as percentage
                  additionalProperties:
                    type: integer
                    nullable: true
                    description: >-
                      Individual criterion scores (column names are dynamic
                      based on scorecard criteria)
              example:
                - Date: '2024-05-12 09:00:00'
                  Assessment Date: '2024-05-13 14:30:00'
                  Reviewed Agent: John Doe
                  Reviewer: Jane Smith
                  State: Reviewed
                  Ticket ID: 4711
                  Total Score: 54
                  Total Score (%): 85.5
                  Communication Quality - Clarity: 4
                  Communication Quality - Grammar: 5
                  Problem Resolution - Solution Quality: 8
            application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
              schema:
                type: string
                format: binary
                description: >
                  Excel file containing the export data. When `scorecardId` is
                  omitted,

                  the file contains multiple sheets (one per scorecard with
                  assessments).
            text/csv:
              schema:
                type: string
                format: binary
        '403':
          description: Unauthorized – user lacks `qualityViewAssessmentAll` permission.
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
components:
  parameters:
    limitParam:
      name: limit
      in: query
      required: false
      description: The number of items to return
      schema:
        type: integer
        default: 100
        minimum: 1
        maximum: 1000
      example: 100
    offsetParam:
      name: offset
      in: query
      required: false
      description: The number of items to skip
      schema:
        type: integer
        default: 0
        minimum: 0
      example: 0
  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

````