/gradingPeriods

A Grading Period is a time frame when grades are given out, like the First Six Weeks or First Trimester. It usually divides a school session, but not always. As part of the Roster collection, SIS vendors need to create a student's schedule for the school year. For testing, they should provide data for six courses the student is taking. Check the instructions under each endpoint use case for details on what information to include.

GET on /courses
Submit /gradingPeriods
Submit /sessions
Submit /courseOffererings
Submit /sections
Submit /studentSectionAssociations
Submit /grades
GET on /staff
Submit /StaffSectionAssociations

This endpoint is NOT expected from Choice schools.

Data Properties:

#	Property Name	Data Type	Public (Required/ Optional/ Conditional)	Choice (Required/ Optional/ Conditional)	Business Definition	Data Element Page
1.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
2.0	gradingPeriodName (2025-26 onward)	string	REQ'D	NOT REQ'D	The school's descriptive name of the grading period
3.0	periodSequence (2024-25 and prior)	integer	OPT	NOT REQ'D	The sequential order of this period relative to other periods.	https://dpi.wi.gov/wise/data-elements/sequenceofcourse
4.0	schoolReference
5.0	schoolId	big integer	REQ'D	NOT REQ'D	The identifier assigned to a school. Format change from Integer to Big Integer (2025-26 SY and later)	https://dpi.wi.gov/wise/data-elements/gradingperiodschoolid
6.0	schoolYearTypeReference
7.0	schoolYear	integer	REQ'D	NOT REQ'D	Key for School Year	https://dpi.wi.gov/wise/data-elements/school-year
8.0	beginDate	string	REQ'D	NOT REQ'D	Month, day, and year of the first day of the GradingPeriod.	https://dpi.wi.gov/wise/data-elements/gradingperiodbeginandend
9.0	endDate	string	REQ'D	NOT REQ'D	Month, day, and year of the last day of the GradingPeriod.	https://dpi.wi.gov/wise/data-elements/gradingperiodbeginandend
10.0	totalInstructionalDays	integer	REQ'D	NOT REQ'D	Total days available for educational instruction during the GradingPeriod.	https://dpi.wi.gov/wise/data-elements/gradingperiodtotalinstructionaldays

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 the grading period during the school year in which the grade is offered (2025-26 SY and after)

To set up a student's schedule for a school year, SIS vendors need to submit gradingPeriods for the schedule using gradingPeriodDescriptor values.

To be able to submit the /courseOfferings endpoint, the /gradingPeriods (and the /sessions endpoint) should be submitted.

POST on / gradingPeriod:

{
"schoolReference": {
"schoolId": 7525,
},
"schoolYearTypeReference": {
"schoolYear": 2026,
},
"gradingPeriodDescriptor": "uri://dpi.wi.gov/GradingPeriodDescriptor#07",
"gradingPeriodName": "660",
"periodSequence": 1,
"beginDate": "2025-07-03",
"totalInstructionalDays": "150",
"endDate": "2026-06-05",
}

JSON Sample:

{
	"schoolReference": {
		"schoolId": 7525
	},
	"schoolYearTypeReference": {
		"schoolYear": 2021
	},
	"gradingPeriodDescriptor": "uri://dpi.wi.gov/GradingPeriodDescriptor#07",
	"periodSequence": 1,
	"beginDate": "2020-07-03",
	"totalInstructionalDays": "150",
	"endDate": "2021-06-05"
}