/grades

Roster is a collection within WISEdata that collects coursework data from schools. Roster data is required for all grade levels except PK, including the /grade endpoint for Pass/Fail. LEAs will receive a validation message in WISEdata Portal when the /grade endpoint is missing for grade levels 9 to 12.

This endpoint is NOT expected from Choice schools.

Ed-Fi Tech Docs: v5 StudentGrade > Grade, https://techdocs.ed-fi.org/display/EDFICERT/v4+StudentGrade+%3E+Grade (2024/25 SY and prior)

Data Properties:

#	Property Name	Data Type	Public (Required/ Optional/ Conditional)	Choice (Required/ Optional/ Conditional)	Business Definition	Data Element Page
1.0	gradeTypeDescriptor	string	REQ'D	NOT REQ'D	The type of grade reported. 'Final' gradeType is the only allowable gradeTypeDescriptor	Grade Type
2.0	gradingPeriodReference	array
3.0	gradingPeriodDescriptor	string	REQ'D	NOT REQ'D	The name of the period for which grades are reported.	Grading Period Descriptor
4.0	periodSequence	integer	REQ'D	NOT REQ'D	The sequential order of this period relative to other periods.	Sequence of Course
5.0	schoolId	integer	REQ'D	NOT REQ'D	The identifier assigned to a school.	School ID
6.0	schoolYear	integer	REQ'D	NOT REQ'D	The identifier for the grading period school year.	School Year
7.0	studentSectionAssociationReference	array
8.0	localCourseCode	string	REQ'D	NOT REQ'D	The local code assigned by the School that identifies the course offering provided for the instruction of students.The identifier assigned to a school.	Local Course Code
9.0	schoolId	integer	REQ'D	NOT REQ'D	The identifier for the school year.	School ID
10.0	schoolYear	integer	REQ'D	NOT REQ'D	The local identifier assigned to a section.	School Year
11.0	sectionIdentifier	string	REQ'D	NOT REQ'D	The local identifier assigned to a section.	Unique Section Code
12.0	sessionName	string	REQ'D	NOT REQ'D	The identifier for the calendar for the academic session (e.g., 2010/11, 2011 Summer).	Session Name
13.0	studentUniqueId	string	REQ'D	NOT REQ'D	A unique alphanumeric code assigned to a student.	WISEid
14.0	letterGradeEarned	string	OPT	NOT REQ'D	A final or interim (grading period) indicator of student performance in a class as submitted by the instructor.	Letter Grade Earned
15.0	numericGradeEarned	number	OPT	NOT REQ'D	A final or interim (grading period) indicator of student performance in a class as submitted by the instructor.	Numeric Grade Earned
16.0	performanceBaseConversionDescriptor	string	CONDITINALLY REQ'D	NOT REQ'D	A conversion of the level to a standard set of performance levels.	Performance Base Conversion Type

Descriptors:

Namespace	Code Value	Short Description	Description

Namespace	Code Value	Short Description	Description
uri://ed-fi.org/gradeTypeDescriptor
uri://ed-fi.org/gradingPeriodDescriptor
uri://ed-fi.org/performanceBaseConversionDescriptor

Use Cases:

#	Use Case Title	Use Case Description	What to Submit/retrieve

#	Use Case Title	Use Case Description	What to Submit/retrieve
1.0	Sending grades for a course that a student is enrolled in, which has multiple studentSectionAssociations for the same logical class due to change of begin dates	Only one ‘Final grade’ will be awarded to the student for the logical class irrespective of having multiple studentSectionAssociations with change in Begin Dates. Only one /grades endpoint should be submitted with a reference to one /studentSectionAssociation for the entire logical class. It is expected to receive the most recent studentSectionAssociation with the latest beginDate for the final grade record. Prerequisites: To be able to submit the /grades endpoint, the /gradingPeriod =endpoint should be submitted first (/grades has gradingPeriod reference). To be able to submit the /grades endpoint, the /studentSectionAssociation endpoint should be submitted first (/grades has studentSectionAssociation reference).	POST on /grades: gradingPeriodReference: gradingPerioddescriptor: uri://dpi.wi.gov/GradingPeriodDescriptor#07 periodSequence: 1 schoolId: 7525 schoolyear: 2021 studentSectionAssociationReference: studentUniqueId: 8660232105 schoolId: 7525 localCourseCode: LCC-121941 sectionIdentifier: Section-121941 schoolYear: 2021, sessionName: Sessions-121941 gradetypeDescriptor: uri://dpi.wi.gov/GradeTypeDescriptor#Final performanceBaseConversionDescriptor: uri://dpi.wi.gov/PerformanceBaseConversionDescriptor#P letterGradeEarned: A numericGradeEarned: 01
2.0	Sending grades for a course that is taught in a ‘Semester’, but has two final grades at the end of each Quarter	Since ‘Final Grades’ are awarded at the end of each Quarter, the ‘Term’ should be set up as a ‘Quarter’ and not as a ‘Semester’. This will allow one ‘Final grade’ to be submitted for the term set up.	POST on /grades
3.0	Sending grades for a course that is taught in a ‘Quarter’, but the ‘Final Grade’ is awarded at the end of two Quarter, i.e a ‘Semester’	Since ‘Final Grades’ are awarded at the end of the ‘Semester’ , the ‘Term’ should be set up as a ‘Semester’ and not as a ‘Quarter’ . This will allow one ‘Final grade’ to be submitted for the term set up.	POST on /grades
4.0	Sending grades for multiple courses taught in the same class (e.g. Math and Science)	This should be reported as two different courses: one with a reference to the Math course, and the other with a reference to the Science course. The /grades endpoint should be submitted separately with the association to each course identifying student’s performance to determine Pass, Fail, or Incomplete.	POST on /grades

JSON Sample:

{
	"gradingPeriodReference": {
		"gradingPerioddescriptor": "uri://dpi.wi.gov/GradingPeriodDescriptor#07",
		"periodSequence": 1,
		"schoolId": 7525,
		"schoolYear": 2021
	},
	"studentSectionAssociationReference": {
		"studentUniqueId": "8660232105",
		"schoolId": 7525,
		"localCourseCode": "LCC-121941",
		"sectionIdentifier": "Section-121941",
		"schoolYear": 2021,
		"sessionName": "Sessions-121941"
	},
	"gradetypeDescriptor": "uri://dpi.wi.gov/GradeTypeDescriptor#Final",
	"performanceBaseConversionDescriptor": "uri://dpi.wi.gov/PerformanceBaseConversionDescriptor#P",
	"letterGradeEarned": "A",
	"numericGradeEarned": "01"
}

WI DPI WISEdata Ed-Fi Docs