> ## Documentation Index > Fetch the complete documentation index at: https://developers.govworx.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Evaluations > Get a paginated list of QA Evaluations for a user ## OpenAPI ````yaml https://app.govworx.net/u/api-docs get /api/v1/external/qa/user/{userId}/evaluations openapi: 3.1.0 info: title: GovWorx Data API description: Interfaces to access data produced and organized by GovWorx Applications. termsOfService: http://swagger.io/terms/ version: '1.0' servers: - url: https://app.govworx.net security: [] tags: - name: TRAIN description: Training Phase and Enrollment Records - name: Audit Log Export description: Programmatically pull audit records into your SIEM solution - name: Knowledge description: >- Push and version guide cards and instruction cards into GovWorx from external systems (e.g., APCO, PowerPhone, IAED). ## Concepts **Knowledge entry:** A guide card or instruction card identified by a GovWorx-internal `id` and your partner-supplied `externalId`. Each entry carries one or more immutable versions. **Version:** An immutable snapshot of the guide card content created by `POST /` (create) or `POST /{knowledgeId}/versions` (append). Only one version is published (active) at a time. **Section ownership (`apiControl`):** A single top-level `apiControl` object on each request declares which sections are owned by the API and which are managed within GovWorx. API-owned sections are fully overwritten on every append. GovWorx-owned sections are editable inside GovWorx and carried forward automatically — do not include their content in append payloads. Flags are set once at creation and are immutable between versions. ## referenceId lifecycle GovWorx assigns a stable `referenceId` to every item in every content list on create. These identifiers are echoed back in the create/append response. **Store them.** On future appends, echo a `referenceId` to update the existing item in place. Omit the `referenceId` to add a new item (a fresh id is generated). Supplying an unknown `referenceId` — one not present in the previous version — is rejected (400). Reference id formats: `q-{8 hex}` (questions), `si-{8 hex}` (spoken instructions), `ca-{8 hex}` (CAD actions), `sms-{8 hex}` (SMS messages), `dt-{8 hex}` (dispatch triggers). ## Authentication All endpoints require a bearer token with the `Manage Knowledge` permission. - name: Incident description: Upload a new Incident to the system - name: MCP Resources description: MCP Resource endpoints for external integrations - name: Quality Assurance description: QA evaluation and feedback report endpoints - name: Users description: User Records externalDocs: description: GovWorx Developer Docs url: https://api.govworx.ai paths: /api/v1/external/qa/user/{userId}/evaluations: get: tags: - Quality Assurance summary: List Evaluations description: Get a paginated list of QA Evaluations for a user operationId: getUserEvaluations parameters: - name: userId in: path required: true schema: type: integer format: int64 - name: pageable in: query required: true schema: $ref: '#/components/schemas/Pageable' responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/PageUserEvaluationDto' components: schemas: Pageable: type: object properties: page: type: integer format: int32 minimum: 0 size: type: integer format: int32 minimum: 1 sort: type: array items: type: string PageUserEvaluationDto: type: object properties: totalElements: type: integer format: int64 totalPages: type: integer format: int32 last: type: boolean size: type: integer format: int32 content: type: array items: $ref: '#/components/schemas/UserEvaluationDto' number: type: integer format: int32 sort: $ref: '#/components/schemas/SortObject' first: type: boolean numberOfElements: type: integer format: int32 pageable: $ref: '#/components/schemas/PageableObject' empty: type: boolean UserEvaluationDto: type: object properties: id: type: integer format: int64 eventId: type: integer format: int64 userId: type: integer format: int64 eventPersonnelId: type: integer format: int64 status: type: string enum: - PENDING - IN_PROGRESS - COMPLETED - SANDBOX_COMPLETED - SIM_COMPLETED - SIM_PROCESSING - EXCLUDED - ERRORED evaluationTemplate: $ref: '#/components/schemas/SummaryEvaluationTemplateDto' results: type: array items: $ref: '#/components/schemas/UserEvaluationCriteriaResultDto' uniqueItems: true completedBy: type: integer format: int64 eventSummary: $ref: '#/components/schemas/EvaluationEventSummary' eventTimes: $ref: '#/components/schemas/EvaluationEventTimes' scaleScoreLevel: type: string rawPercentScore: type: number format: double earnedScore: type: integer format: int32 totalPossibleScore: type: integer format: int32 isPointsOff: type: boolean clearReason: type: string isTraining: type: boolean isSandbox: type: boolean hasOverride: type: boolean phaseEnrollments: type: array items: $ref: '#/components/schemas/PhaseEnrollmentSummaryDto' uniqueItems: true SortObject: type: object properties: empty: type: boolean sorted: type: boolean unsorted: type: boolean PageableObject: type: object properties: offset: type: integer format: int64 sort: $ref: '#/components/schemas/SortObject' pageSize: type: integer format: int32 paged: type: boolean pageNumber: type: integer format: int32 unpaged: type: boolean SummaryEvaluationTemplateDto: type: object properties: id: type: integer format: int64 name: type: string color: type: string sandboxMode: type: boolean sandboxExpiresAt: type: string format: date-time active: type: boolean templateIdentifier: type: string version: type: integer format: int32 UserEvaluationCriteriaResultDto: type: object properties: id: type: integer format: int64 eventId: type: integer format: int64 userId: type: integer format: int64 evaluationTemplateCriteria: oneOf: - $ref: '#/components/schemas/AutoEvaluationTemplateCriteriaDto' - $ref: '#/components/schemas/CommentEvaluationTemplateCriteriaDto' - $ref: '#/components/schemas/ConditionEvaluationTemplateCriteriaDto' - $ref: '#/components/schemas/EvaluationTemplateSectionDto' - $ref: '#/components/schemas/FileUploadEvaluationTemplateCriteriaDto' - $ref: >- #/components/schemas/GuidecardQuestionsEvaluationTemplateCriteriaDto - $ref: >- #/components/schemas/GuidecardSelectionEvaluationTemplateCriteriaDto - $ref: '#/components/schemas/NICSEvaluationTemplateCriteriaDto' - $ref: '#/components/schemas/PassFailEvaluationTemplateCriteriaDto' - $ref: '#/components/schemas/PreArrivalEvaluationTemplateCriteriaDto' - $ref: '#/components/schemas/RatingEvaluationTemplateCriteriaDto' - $ref: '#/components/schemas/SpeedEvaluationTemplateCriteriaDto' - $ref: '#/components/schemas/StandardEvaluationTemplateCriteriaDto' score: type: integer format: int32 totalPossibleScore: type: integer format: int32 isPassing: type: boolean classification: type: string enum: - STRENGTH - COACHING_OPPTY - COMPETENT - EXCLUDED comment: type: string speedSeconds: type: integer format: int32 explanation: type: string qaResponse: $ref: '#/components/schemas/QAResponse' overrideBy: type: integer format: int64 overrideAiOriginalResult: type: boolean overrideReason: type: string protocolResults: type: array items: $ref: '#/components/schemas/UserEvaluationProtocolResultDto' EvaluationEventSummary: type: object properties: summary: type: string variableValues: type: array items: $ref: '#/components/schemas/LLMEvaluationVariableValue' EvaluationEventTimes: type: object properties: times: type: array items: $ref: '#/components/schemas/EvaluationEventCalculatedTime' PhaseEnrollmentSummaryDto: type: object properties: id: type: integer format: int64 tenantId: type: integer format: int64 phaseId: type: integer format: int64 phaseName: type: string user: $ref: '#/components/schemas/UserDto' primaryTrainingOfficer: $ref: '#/components/schemas/UserDto' startDate: type: string format: date originalPlannedEndDate: type: string format: date projectedEndDate: type: string format: date actualEndDate: type: string format: date status: type: string enum: - SCHEDULED - IN_PROGRESS - SUBMITTED - WAITING_SIGNOFF - COMPLETE - CANCELLED statusReason: type: string signoffId: type: integer format: int64 AutoEvaluationTemplateCriteriaDto: allOf: - $ref: '#/components/schemas/EvaluationTemplateCriteriaDto' - type: object properties: taskId: type: string smartTask: oneOf: - $ref: '#/components/schemas/DataExtractionSmartTaskDto' - $ref: '#/components/schemas/QuestionAnswerSmartTaskDto' - $ref: '#/components/schemas/SummarizeSmartTaskDto' - $ref: '#/components/schemas/TaggingSmartTaskDto' CommentEvaluationTemplateCriteriaDto: allOf: - $ref: '#/components/schemas/EvaluationTemplateCriteriaDto' ConditionEvaluationTemplateCriteriaDto: allOf: - $ref: '#/components/schemas/EvaluationTemplateCriteriaDto' - type: object properties: predicates: type: array items: $ref: '#/components/schemas/EvalConditionPredicate' smartTask: oneOf: - $ref: '#/components/schemas/DataExtractionSmartTaskDto' - $ref: '#/components/schemas/QuestionAnswerSmartTaskDto' - $ref: '#/components/schemas/SummarizeSmartTaskDto' - $ref: '#/components/schemas/TaggingSmartTaskDto' EvaluationTemplateSectionDto: allOf: - $ref: '#/components/schemas/EvaluationTemplateCriteriaDto' FileUploadEvaluationTemplateCriteriaDto: allOf: - $ref: '#/components/schemas/EvaluationTemplateCriteriaDto' GuidecardQuestionsEvaluationTemplateCriteriaDto: allOf: - $ref: '#/components/schemas/EvaluationTemplateCriteriaDto' - type: object properties: criteriaWeight: $ref: '#/components/schemas/EvaluationTemplateCriteriaWeightDto' GuidecardSelectionEvaluationTemplateCriteriaDto: allOf: - $ref: '#/components/schemas/EvaluationTemplateCriteriaDto' NICSEvaluationTemplateCriteriaDto: allOf: - $ref: '#/components/schemas/EvaluationTemplateCriteriaDto' PassFailEvaluationTemplateCriteriaDto: allOf: - $ref: '#/components/schemas/EvaluationTemplateCriteriaDto' PreArrivalEvaluationTemplateCriteriaDto: allOf: - $ref: '#/components/schemas/EvaluationTemplateCriteriaDto' - type: object properties: criteriaWeight: $ref: '#/components/schemas/EvaluationTemplateCriteriaWeightDto' RatingEvaluationTemplateCriteriaDto: allOf: - $ref: '#/components/schemas/EvaluationTemplateCriteriaDto' - type: object properties: maxRating: type: integer format: int32 minRating: type: integer format: int32 SpeedEvaluationTemplateCriteriaDto: allOf: - $ref: '#/components/schemas/EvaluationTemplateCriteriaDto' - type: object properties: startTimeField: type: string endTimeField: type: string durationSeconds: type: integer format: int32 StandardEvaluationTemplateCriteriaDto: allOf: - $ref: '#/components/schemas/EvaluationTemplateCriteriaDto' - type: object properties: standardCriteriaId: type: string QAResponse: type: object properties: smartTaskId: type: integer format: int64 standardCriteriaId: type: string passing: type: boolean answer: type: array items: oneOf: - $ref: '#/components/schemas/AllRadioTranscriptionContextSource' - $ref: '#/components/schemas/CallAudioMetadataContextSource' - $ref: '#/components/schemas/DraftReportContextSource' - $ref: '#/components/schemas/EPCRContextSource' - $ref: '#/components/schemas/EPCRDataContextSource' - $ref: '#/components/schemas/IncidentAuditContextSource' - $ref: '#/components/schemas/IncidentFieldContextSource' - $ref: '#/components/schemas/IncidentNoteContextSource' - $ref: '#/components/schemas/RMSReportContextSource' - $ref: '#/components/schemas/RadioTranscriptionContextSource' - $ref: '#/components/schemas/TranscriptionContextSource' - $ref: '#/components/schemas/UnitRespondersContextSource' explanation: type: string UserEvaluationProtocolResultDto: type: object properties: id: type: integer format: int64 percentScore: type: integer format: int32 guideCardName: type: string evaluationData: $ref: '#/components/schemas/ProtocolEvaluationSummary' isEdited: type: boolean overrideBy: type: integer format: int64 overrideByName: type: string overrideReason: type: string overrideAt: type: string format: date-time LLMEvaluationVariableValue: type: object properties: value: type: string variable: type: string explanation: type: string index: type: integer format: int32 originalValue: type: string overrideBy: type: integer format: int64 overrideReason: type: string overrideAt: type: string format: date-time EvaluationEventCalculatedTime: type: object properties: explanation: type: string seconds: type: number format: float name: type: string segment: $ref: '#/components/schemas/TranscriptionContextSource' UserDto: type: object properties: email: type: string firstName: type: string lastName: type: string loginEnabled: type: boolean notificationEmail: type: string id: type: integer format: int64 tenantId: type: integer format: int64 idpSub: type: string personnelId: type: string roleId: type: integer format: int64 isSuperAdmin: type: boolean isSystemUser: type: boolean mfaEnabled: type: boolean lastLoginAt: type: string format: date-time isSupervisor: type: boolean isTemplatePublishingAllowed: type: boolean vlrIdentifier: type: string passwordExpiresAt: type: string format: date-time isPasswordExpired: type: boolean isSupportUser: type: boolean investmentTrainingPipeline: type: boolean EvaluationTemplateCriteriaDto: type: object discriminator: propertyName: type properties: id: type: integer format: int64 description: type: string orderIndex: type: integer format: int32 score: type: integer format: int32 scoringCriteriaCriticalityLevelId: type: integer format: int64 skillArea: $ref: '#/components/schemas/SkillAreaDto' parentCriteriaId: type: integer format: int64 type: type: string DataExtractionSmartTaskDto: allOf: - $ref: '#/components/schemas/SmartTaskDto' QuestionAnswerSmartTaskDto: allOf: - $ref: '#/components/schemas/SmartTaskDto' SummarizeSmartTaskDto: allOf: - $ref: '#/components/schemas/SmartTaskDto' TaggingSmartTaskDto: allOf: - $ref: '#/components/schemas/SmartTaskDto' EvalConditionPredicate: type: object properties: variable: type: string operator: type: string value: type: string EvaluationTemplateCriteriaWeightDto: type: object properties: id: type: integer format: int64 evaluationTemplateCriteriaId: type: integer format: int64 criticalWeight: type: integer format: int32 nonCriticalWeight: type: integer format: int32 AllRadioTranscriptionContextSource: allOf: - $ref: '#/components/schemas/iContextSource' - type: object properties: speakerSegment: $ref: '#/components/schemas/SpeakerSegment' mediaId: type: integer format: int64 identifiedSpeaker: type: boolean identifiedUserId: type: integer format: int64 timestamp: type: string format: date-time contentWithSpeaker: type: string start: type: number format: float CallAudioMetadataContextSource: allOf: - $ref: '#/components/schemas/iContextSource' DraftReportContextSource: allOf: - $ref: '#/components/schemas/iContextSource' - type: object properties: rmsReportId: type: integer format: int64 sentence: type: string sequence: type: integer format: int32 EPCRContextSource: allOf: - $ref: '#/components/schemas/iContextSource' - type: object properties: epcrId: type: integer format: int64 sentence: type: string sequence: type: integer format: int32 EPCRDataContextSource: allOf: - $ref: '#/components/schemas/iContextSource' - type: object properties: epcrId: type: integer format: int64 sentence: type: string sequence: type: integer format: int32 IncidentAuditContextSource: allOf: - $ref: '#/components/schemas/iContextSource' IncidentFieldContextSource: allOf: - $ref: '#/components/schemas/iContextSource' IncidentNoteContextSource: allOf: - $ref: '#/components/schemas/iContextSource' - type: object properties: noteBy: type: string RMSReportContextSource: allOf: - $ref: '#/components/schemas/iContextSource' - type: object properties: rmsReportId: type: integer format: int64 sentence: type: string sequence: type: integer format: int32 RadioTranscriptionContextSource: allOf: - $ref: '#/components/schemas/iContextSource' - type: object properties: speakerSegment: $ref: '#/components/schemas/SpeakerSegment' mediaId: type: integer format: int64 identifiedSpeaker: type: boolean identifiedUserId: type: integer format: int64 timestamp: type: string format: date-time contentWithSpeaker: type: string start: type: number format: float TranscriptionContextSource: type: object properties: speakerSegment: $ref: '#/components/schemas/SpeakerSegment' mediaId: type: integer format: int64 identifiedSpeaker: type: boolean identifiedUserId: type: integer format: int64 id: type: integer format: int32 type: type: string content: type: string start: type: number format: float order: type: integer format: int32 contentWithSpeaker: type: string UnitRespondersContextSource: allOf: - $ref: '#/components/schemas/iContextSource' ProtocolEvaluationSummary: type: object properties: protocolName: type: string knowledgeId: type: integer format: int64 knowledgeVersionId: type: integer format: int64 knowledgeSectionId: type: integer format: int64 allCallersKnowledgeId: type: integer format: int64 allCallersKnowledgeVersionId: type: integer format: int64 allCallersKnowledgeSectionId: type: integer format: int64 finalScore: type: integer format: int32 selection: $ref: '#/components/schemas/GuidecardSelectionStepResultDto' selectionScore: type: integer format: int32 questions: $ref: '#/components/schemas/GuidecardQuestionsStepResultDto' questionsScore: type: integer format: int32 preArrival: $ref: '#/components/schemas/PreArrivalStepResultDto' preArrivalScore: type: integer format: int32 allCallers: $ref: '#/components/schemas/AllCallersStepResultDto' allCallersScore: type: integer format: int32 assist: $ref: '#/components/schemas/AssistInfo' SkillAreaDto: type: object properties: id: type: integer format: int64 refId: type: string name: type: string description: type: string SmartTaskDto: type: object discriminator: propertyName: type properties: id: type: integer format: int64 prompt: type: string contextSources: type: array items: type: string additionalInstructions: type: string overrideGeneratedInstructions: type: string type: type: string iContextSource: type: object discriminator: propertyName: type properties: id: type: integer format: int32 type: type: string content: type: string order: type: integer format: int32 SpeakerSegment: type: object properties: id: type: string start: type: number format: float end: type: number format: float transcriptionText: type: string sentiment: type: string sentimentScore: type: number format: float speakerIdx: type: integer format: int32 channel: type: integer format: int32 speaker: type: string objectKey: type: string words: type: array items: $ref: '#/components/schemas/TranscriptionWord' originalText: type: string smoothedWords: type: array items: $ref: '#/components/schemas/SmoothedWord' identifiedUserId: type: integer format: int64 GuidecardSelectionStepResultDto: type: object properties: selectedGuidecardId: type: integer format: int64 selectedKnowledgeId: type: integer format: int64 aiRecommendedGuidecardId: type: integer format: int64 aiRecommendedKnowledgeId: type: integer format: int64 isCorrect: type: boolean score: type: integer format: int32 confidence: type: integer format: int32 justification: type: string feedback: type: string scoringBreakdown: $ref: '#/components/schemas/SelectionScoringBreakdown' overrideBy: type: integer format: int64 overrideByName: type: string overrideAt: type: string format: date-time overrideReason: type: string GuidecardQuestionsStepResultDto: type: object properties: questions: type: array items: $ref: '#/components/schemas/AssistantExecutionDetailsQuestionDto' aiExplanation: type: string contextSources: type: array items: $ref: '#/components/schemas/TranscriptionContextSource' summary: type: string scoringBreakdown: $ref: '#/components/schemas/QuestionsScoringBreakdown' PreArrivalStepResultDto: type: object properties: instructions: type: array items: $ref: '#/components/schemas/PreArrivalInstructionDto' aiExplanation: type: string contextSources: type: array items: $ref: '#/components/schemas/TranscriptionContextSource' scoringBreakdown: $ref: '#/components/schemas/PreArrivalScoringBreakdown' AllCallersStepResultDto: type: object properties: questions: type: array items: $ref: '#/components/schemas/AssistantExecutionDetailsQuestionDto' aiExplanation: type: string contextSources: type: array items: $ref: '#/components/schemas/TranscriptionContextSource' summary: type: string scoringBreakdown: $ref: '#/components/schemas/QuestionsScoringBreakdown' AssistInfo: type: object properties: requestedKnowledgeSectionId: type: integer format: int64 assistantIdentifier: type: string requestedGuidecardName: type: string requestedKnowledgeId: type: integer format: int64 diverged: type: boolean TranscriptionWord: type: object properties: word: type: string start: type: number format: float end: type: number format: float score: type: number format: float SmoothedWord: type: object properties: wordIndex: type: integer format: int32 original: type: string smoothed: type: string SelectionScoringBreakdown: type: object properties: isCorrect: type: boolean aiRecommendedGuidecardId: type: integer format: int64 selectedGuidecardId: type: integer format: int64 justification: type: string AssistantExecutionDetailsQuestionDto: type: object properties: questionId: type: integer format: int64 referenceId: type: string questionText: type: string isCritical: type: boolean isOptional: type: boolean answered: type: boolean answer: type: string parentQuestionId: type: integer format: int64 displayCriteria: type: string lowQualityCriteria: type: string highQualityCriteria: type: string aiSummary: type: string aiScore: type: integer format: int32 source: type: string conditionMet: type: boolean scoring: $ref: '#/components/schemas/QuestionScoring' askedAtSeconds: type: integer format: int64 answeredAtSeconds: type: integer format: int64 answeredUnprompted: type: boolean askedSegment: $ref: '#/components/schemas/SpeakerSegment' answerSegment: $ref: '#/components/schemas/SpeakerSegment' overrideBy: type: integer format: int64 overrideByName: type: string overrideAt: type: string format: date-time overrideReason: type: string QuestionsScoringBreakdown: type: object properties: totalQuestions: type: integer format: int32 criticalQuestions: type: integer format: int32 nonCriticalQuestions: type: integer format: int32 criticalAnswered: type: integer format: int32 nonCriticalAnswered: type: integer format: int32 criticalWeight: type: number format: double nonCriticalWeight: type: number format: double totalPossibleWeight: type: number format: double earnedWeight: type: number format: double optionalQuestions: type: integer format: int32 conditionNotMetQuestions: type: integer format: int32 PreArrivalInstructionDto: type: object properties: instructionId: type: integer format: int64 referenceId: type: string instructionText: type: string isCritical: type: boolean delivered: type: boolean score: type: integer format: int32 aiSummary: type: string deliveredSegment: $ref: '#/components/schemas/SpeakerSegment' scoring: $ref: '#/components/schemas/InstructionScoring' overrideBy: type: integer format: int64 overrideByName: type: string overrideAt: type: string format: date-time overrideReason: type: string PreArrivalScoringBreakdown: type: object properties: totalInstructions: type: integer format: int32 criticalInstructions: type: integer format: int32 nonCriticalInstructions: type: integer format: int32 criticalDelivered: type: integer format: int32 nonCriticalDelivered: type: integer format: int32 criticalWeight: type: number format: double nonCriticalWeight: type: number format: double totalPossibleWeight: type: number format: double earnedWeight: type: number format: double QuestionScoring: type: object properties: includesInScore: type: boolean exclusionReason: type: string questionWeight: type: number format: double percentContribution: type: number format: double pointValue: type: number format: double InstructionScoring: type: object properties: instructionWeight: type: number format: double percentContribution: type: number format: double pointValue: type: number format: double ````