Export quality assessments

`GET /export/qualityAssessments`

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&amp;scorecardId=1
GET /api/mind/export/qualityAssessments?format=xlsx&amp;from=2024-01-01&amp;to=2024-12-31

Query parameters

formatenumquery

Export format. Defaults to the backend defaultDateExportFormat setting.

scorecardIdintegerquery

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

fromstringquery

Start date filter (inclusive). Only assessments created on or after this date are included.

tostringquery

End date filter (inclusive). Only assessments created on or before this date are included.

limitintegerquery

The number of items to return

offsetintegerquery

The number of items to skip

Responses

200 — Export returned successfully.

Response Example

[
  {
    "Date": "2026-01-01T12:00:00Z",
    "Assessment Date": "2026-01-01T12:00:00Z",
    "Reviewed Agent": "string",
    "Reviewer": "string",
    "State": "Ready for Review",
    "Ticket ID": 1,
    "Total Score": 1,
    "Total Score (%)": 1
  }
]

403 — Unauthorized – user lacks qualityViewAssessmentAll permission.

500 — Internal server error