v2

latestOpenAPI 3.1.0Proprietary - Licensed to Authorized Customers Only2026-07-31611061.1 MB
GradeUpperSecondary

Get a GradeUpperSecondary

Retrieves the GradeUpperSecondary with the given ID.

get/grade-upper-secondary/{id}

Path parameters

idstring uuid required
Example:123e4567-e89b-12d3-a456-426614174000

The unique identifier of the GradeUpperSecondary to retrieve

Response

Response for GradeUpperSecondary Get operation - returns the requested GradeUpperSecondary

idstring uuid required

Unique identifier for the GradeUpperSecondary

studentIDstring uuid required

The ID of the student the grade belongs to. Must reference a student within the organization who has an active placement at the school referenced by SchoolID.

schoolIDstring uuid required

The ID of the school where the student received the grade. Must reference a school within the organization.

courseCodestring required

The national course code as defined by the Swedish school authorities (e.g. "MATMAT01a" for Mathematics 1a).

languageCodestring nullable

The language code for the grade, used when the course is taught in a specific language.

teacher1EmployeeIDstring uuid nullable

The ID of the primary teacher responsible for the grade. Must reference an Employee who has an active placement at the school referenced by SchoolID.

teacher2EmployeeIDstring uuid nullable

The ID of the secondary teacher responsible for the grade. Must reference an Employee who has an active placement at the school referenced by SchoolID.

grade'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'MISSING'

The grade awarded to a student

gradeDatestring date nullable

The date the grade was awarded.

gradeCommentstring nullable

A comment about the grade from the teacher.

extent'Normal' | 'Extended' | 'Reduced'

The extent of the course in the study plan

schoolYear'1' | '2' | '3'

The school year of the student when the grade was awarded (upper secondary school)

section'General' | 'Program' | 'Orientation' | 'Specialization' | 'Individual' | 'Project' | 'Elementary'

The section/type of the course in the study plan

teacherCommentstring nullable

A comment from the teacher about the student's performance.

includeOnFinalGradeboolean required

Whether this course grade should be included when calculating the student's final grade certificate.

programTitlestring nullable

The title of the program this course belongs to. Used to associate the course with a specific educational program.

startDatestring date nullable

The date the student started the course.

endDatestring date nullable

The date the student finished the course.

Example response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "meta": {
    "createdAt": "2024-01-15T10:30:00Z",
    "createdBy": "987fcdeb-51a2-43d1-b567-123456789abc",
    "updatedAt": "2024-01-15T14:45:00Z",
    "updatedBy": "987fcdeb-51a2-43d1-b567-123456789abc"
  },
  "external": {
    "sourceID": "12345678",
    "source": "ExternalIntegrationAPI"
  },
  "studentID": "123e4567-e89b-12d3-a456-426614174000",
  "schoolID": "123e4567-e89b-12d3-a456-426614174000",
  "courseCode": "MATMAT01a",
  "languageCode": "SV",
  "teacher1EmployeeID": "123e4567-e89b-12d3-a456-426614174000",
  "teacher2EmployeeID": "123e4567-e89b-12d3-a456-426614174000",
  "gradeDate": "2025-01-15",
  "gradeComment": "Eleven har visat goda kunskaper i algebra.",
  "teacherComment": "Eleven deltar aktivt och visar stort engagemang.",
  "includeOnFinalGrade": true,
  "programTitle": "Teknikprogrammet",
  "startDate": "2024-08-19",
  "endDate": "2025-01-17"
}