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

# Generate educator report for an assignment

> Aggregates statistics across every graded submission in your organization that shares the given assignmentId. Includes grade distribution, per-criterion analysis, strengths, weaknesses, and a list of all submissions.



## OpenAPI

````yaml /openapi-components.json get /api/v1/assignment-grader/educator-report/{assignmentId}
openapi: 3.0.0
info:
  title: StudyFetch API
  description: API documentation for StudyFetch
  version: '1.0'
  contact: {}
servers:
  - url: https://studyfetchapi.com
    description: Production API Server
security: []
tags: []
paths:
  /api/v1/assignment-grader/educator-report/{assignmentId}:
    get:
      tags:
        - Assignment Grader
      summary: Generate educator report for an assignment
      description: >-
        Aggregates statistics across every graded submission in your
        organization that shares the given assignmentId. Includes grade
        distribution, per-criterion analysis, strengths, weaknesses, and a list
        of all submissions.
      operationId: generateEducatorReport
      parameters:
        - name: assignmentId
          required: true
          in: path
          description: The assignmentId tag used when grading submissions via POST /create
          schema:
            type: string
      responses:
        '200':
          description: Educator report generated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EducatorReportResponseDto'
        '401':
          description: Missing or invalid authentication
        '404':
          description: No submissions match the assignmentId in your organization
      security:
        - x-api-key: []
        - bearerAuth: []
components:
  schemas:
    EducatorReportResponseDto:
      type: object
      properties:
        assignmentId:
          type: string
          description: Assignment ID
        title:
          type: string
          description: Assignment title
        totalSubmissions:
          type: number
          description: Total number of submissions
        statistics:
          description: Grade statistics
          allOf:
            - $ref: '#/components/schemas/StatisticsDto'
        gradeDistribution:
          description: Grade distribution
          allOf:
            - $ref: '#/components/schemas/GradeDistributionDto'
        criteriaAnalysis:
          description: Analysis per criterion
          type: array
          items:
            $ref: '#/components/schemas/CriteriaAnalysisDto'
        strengths:
          description: Top performing criteria
          type: array
          items:
            $ref: '#/components/schemas/PerformanceItemDto'
        weaknesses:
          description: Criteria needing improvement
          type: array
          items:
            $ref: '#/components/schemas/PerformanceItemDto'
        submissions:
          description: List of all submissions
          type: array
          items:
            $ref: '#/components/schemas/SubmissionSummaryDto'
      required:
        - assignmentId
        - title
        - totalSubmissions
        - statistics
        - gradeDistribution
        - criteriaAnalysis
        - strengths
        - weaknesses
        - submissions
    StatisticsDto:
      type: object
      properties:
        averageGrade:
          type: string
          description: Average grade
        minGrade:
          type: string
          description: Minimum grade
        maxGrade:
          type: string
          description: Maximum grade
        standardDeviation:
          type: string
          description: Standard deviation
      required:
        - averageGrade
        - minGrade
        - maxGrade
        - standardDeviation
    GradeDistributionDto:
      type: object
      properties:
        A:
          type: number
          description: Number of A grades (90-100)
        B:
          type: number
          description: Number of B grades (80-89)
        C:
          type: number
          description: Number of C grades (70-79)
        D:
          type: number
          description: Number of D grades (60-69)
        F:
          type: number
          description: Number of F grades (0-59)
      required:
        - A
        - B
        - C
        - D
        - F
    CriteriaAnalysisDto:
      type: object
      properties:
        title:
          type: string
          description: Criterion title
        avgScore:
          type: number
          description: Average score for this criterion
        maxPossible:
          type: number
          description: Maximum possible points
        submissionCount:
          type: number
          description: Number of submissions graded
      required:
        - title
        - avgScore
        - maxPossible
        - submissionCount
    PerformanceItemDto:
      type: object
      properties:
        title:
          type: string
          description: Criterion title
        avgScore:
          type: string
          description: Average score
        maxPossible:
          type: number
          description: Maximum possible points
        performanceRatio:
          type: string
          description: Performance ratio as percentage
      required:
        - title
        - avgScore
        - maxPossible
        - performanceRatio
    SubmissionSummaryDto:
      type: object
      properties:
        id:
          type: string
          description: Submission ID
        studentIdentifier:
          type: string
          description: Student identifier
        grade:
          type: number
          description: Grade percentage
        createdAt:
          format: date-time
          type: string
          description: Submission date
      required:
        - id
        - studentIdentifier
        - grade
        - createdAt
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API Key for server-to-server authentication. Resolves to the owning
        organization.
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        JWT bearer token for user session authentication. Resolves to both
        organization and user.

````