/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/v3+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	https://dpi.wi.gov/wise/data-elements/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.	https://dpi.wi.gov/wise/data-elements/gradingperioddescriptor
4.0	periodSequence	integer	REQ'D	NOT REQ'D	The sequential order of this period relative to other periods.	https://dpi.wi.gov/wise/data-elements/sequenceofcourse
5.0	schoolId	integer	REQ'D	NOT REQ'D	The identifier assigned to a school.	https://dpi.wi.gov/wise/data-elements/schoolid
6.0	schoolYear	integer	REQ'D	NOT REQ'D	The identifier for the grading period school year.	https://dpi.wi.gov/wise/data-elements/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.	https://dpi.wi.gov/wise/data-elements/localcoursecode
9.0	schoolId	big integer	REQ'D	NOT REQ'D	The identifier for the school year. Format change from Integer to Big Integer (2025-26 SY and later)	https://dpi.wi.gov/wise/data-elements/schoolid
10.0	schoolYear	integer	REQ'D	NOT REQ'D	The local identifier assigned to a section.	https://dpi.wi.gov/wise/data-elements/school-year
11.0	sectionIdentifier	string	REQ'D	NOT REQ'D	The local identifier assigned to a section.	https://dpi.wi.gov/wise/data-elements/uniquesectioncode
12.0	sessionName	string	REQ'D	NOT REQ'D	The identifier for the calendar for the academic session (e.g., 2010/11, 2011 Summer).	https://dpi.wi.gov/wise/data-elements/sessionname
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://dpi.wi.gov/gradeTypeDescriptor ( Deprecated 2026-27)	Final	Final Grade	Final Grade
uri://ed-fi.org/gradeTypeDescriptor ( Added 2026-27)	Final	Final	Final
uri://dpi.wi.gov/GradingPeriodDescriptor ( Deprecated 2026-27)	01	End of Year	End of Year
	02	Fifth Six Weeks	Fifth Six Weeks
	03	First Nine Weeks	First Nine Weeks
	04	First Semester	First Semester
	05	First Six Weeks	First Six Weeks
	06	First Summer Session	First Summer Session
	07	First Trimester	First Trimester
	08	Fourth Nine Weeks	Fourth Nine Weeks
	09	Fourth Six Weeks	Fourth Six Weeks
	10	Second Nine Weeks	Second Nine Weeks
	11	Second Semester	Second Semester
	12	Second Six Weeks	Second Six Weeks
	13	Second Summer Session	Second Summer Session
	14	Second Trimester	Second Trimester
	15	Sixth Six Weeks	Sixth Six Weeks
	16	Summer Semester	Summer Semester
	17	Third Nine Weeks	Third Nine Weeks
	18	Third Six Weeks	Third Six Weeks
	19	Third Summer Session	Third Summer Session
	20	Third Trimester	Third Trimester
uri://dpi.wi.gov/GradingPeriodDescriptor (Retained 2026-27)	21	Grading Period 1	Grading Period 1
	22	Grading Period 2	Grading Period 2
	23	Grading Period 3	Grading Period 3
	24	Grading Period 4	Grading Period 4
	25	Grading Period 5	Grading Period 5
	26	Grading Period 6	Grading Period 6
	27	Grading Period 7	Grading Period 7
	28	Grading Period 8	Grading Period 8
	29	Grading Period 9	Grading Period 9
	30	Grading Period 10	Grading Period 10
	31	Grading Period 11	Grading Period 11
	32	Grading Period 12	Grading Period 12
uri://ed-fi.org/gradingPeriodDescriptor ( 2026-27)	Summer Semester	Summer Semester	Summer Semester
	First Semester	First Semester	First Semester
	First Summer Session	First Summer Session	First Summer Session
	Second Semester	Second Semester	Second Semester
	Second Summer Session	Second Summer Session	Second Summer Session
	Second Trimester	Second Trimester	Second Trimester
	First Trimester	First Trimester	First Trimester
	Third Summer Session	Third Summer Session	Third Summer Session
	Third Trimester	Third Trimester	Third Trimester
	Second Nine Weeks	Second Nine Weeks	Second Nine Weeks
	First Nine Weeks	First Nine Weeks	First Nine Weeks
	Third Nine Weeks	Third Nine Weeks	Third Nine Weeks
	First Six Weeks	First Six Weeks	First Six Weeks
	Second Six Weeks	Second Six Weeks	Second Six Weeks
	Fourth Nine Weeks	Fourth Nine Weeks	Fourth Nine Weeks
	Third Six Weeks	Third Six Weeks	Third Six Weeks
	Fourth Six Weeks	Fourth Six Weeks	Fourth Six Weeks
	Sixth Six Weeks	Sixth Six Weeks	Sixth Six Weeks
	Fifth Six Weeks	Fifth Six Weeks	Fifth Six Weeks
	End of Year	End of Year	End of Year
uri://ed-fi.org/performanceBaseConversionDescriptor