1.0

Ability to support different API credentials in different school years (Informational)

• If the vendor supports year-based API credentials, then demonstrate how LEAs enter the API credentials (keys/secrets) in different years.

• If the vendor doesn't support year-based API credentials, then provide instructions on how to switch API credentials to update prior year data, then switch back to the current year's API credentials.

LEA can successfully send data for different school years when they have different API credentials for each year

1.0

Using EducationOrganizationIdentificationSystemDescriptor

Effective the 2026-27SY, the EducationOrganizationIdentificationSystemDescriptor has moved most, excluding AgencyKey, WIR, MDC values to the new ed-fi.org name space. 

SIS vendors should be able to do a GET on /localEducationAgencies and ingest the LEA details into their system. Descriptor values are sourced from uri://ed-fi.org/ and uri://dpi.wi.gov/ (AgencyKey,WIR, MDC)

GET on /localEducationAgencies

2.0

Using EducationOrganizationIdentificationSystemDescriptor (Regression)

2025-2026 SY and prior, this descriptor is sourced from sourced from
 uri://dpi.wi.gov

Descriptor values are sourced from uri://dpi.wi.gov/

1.0

Using OperationalStatusDescriptor 

Effective the 2026-27SY, the OperationalStatusDescriptor has moved all values to the new ed-fi.org name space.

SIS vendors should be able to do a GET on /localEducationAgencies and ingest the LEA details into their system. Descriptor values are sourced from uri://ed-fi.org/

GET on /localEducationAgencies

2.0

Using OperationalStatusDescriptor (Regression)

Prior 2026-27 SY, OperationalStatusDescriptor is sourced from  uri://dpi.wi.gov

Descriptor values are sourced from uri://dpi.wi.gov/

1.0

Using GradeLevelDescriptor (Informational)

Effective the 2026-27SY, the GradeLevelDescriptor has moved to the new ed-fi.org name space. 

Descriptor values are sourced from uri://ed-fi.org/

GET from /schools

Source for /Grades

POST /studentSchool Association

{
"entryDate": "2026-07-02",
"schoolReference": {
"schoolId": 7525,
},
"studentReference": {
"studentUniqueId": "XXXXXXXXXX",
},
"enrollmentTypeDescriptor": "uri://dpi.wi.gov/EnrollmentTypeDescriptor#P",
"entryGradeLevelDescriptor": "uri://ed-fi.org/GradeLevelDescriptor#Eleventh Grade",
"exitWithdrawDate": "2027-06-05",
"exitWithdrawTypeDescriptor": "uri://dpi.wi.gov/exitWithdrawTypeDescriptor#HSC",
"fullTimeEquivalency": 1.0,
"primarySchool": true,
"NextYearGradeLevelDescriptor": "uri://ed-fi.org/GradeLevelDescriptor#Twelfth Grade",

1.1

Submitting a student enrollment record for mid-year enrollment (2025-26 and after)

Starting in the 2025-26 school year, LEAs/vendors are required to report the NextYearGradeLevelDescriptor to indicate the expected grade level for a student’s next enrollment.

POST on /studentSchoolAssociations:
primarySchool: True
enrollmentTypeDescriptor: uri://dpi.wi.gov/EnrollmentTypeDescriptor#P
entryGradeLevelDescriptor: uri://dpi.wi.gov/GradeLevelDescriptor#Ninth Grade
nextYearGradeLevelDescriptor: uri://dpi.wi.gov/GradeLevelDescriptor#Ninth Grade

2.0

Using GradeLevelDescriptor (Informational -Regression)

Prior 2026-27 SY, this descriptor is sourced from sourced from uri://dpi.wi.gov

Descriptor values are sourced from uri://dpi.wi.gov/

POST /studentSchool Association

{

"entryDate": "2025-07-02",

"schoolReference": {

"schoolId": 7525,

},

"studentReference": {

"studentUniqueId": "2181787249",

},

"enrollmentTypeDescriptor": "uri://dpi.wi.gov/EnrollmentTypeDescriptor#P",

"entryGradeLevelDescriptor": "uri://dpi.wi.gov/GradeLevelDescriptor#10"

2.1

Submitting a student enrollment record for mid-year enrollment (2025-26 and after)

Starting in the 2025-26 school year, LEAs/vendors are required to report the NextYearGradeLevelDescriptor to indicate the expected grade level for a student’s next enrollment.

POST on /studentSchoolAssociations:
  primarySchool: True
  enrollmentTypeDescriptor: uri://dpi.wi.gov/EnrollmentTypeDescriptor#P
  entryGradeLevelDescriptor: uri://dpi.wi.gov/GradeLevelDescriptor#06
  nextYearGradeLevelDescriptor: uri://dpi.wi.gov/GradeLevelDescriptor#06

2.2

Submitting a student enrollment record for a student who is not repeating a grade level (2025-26 and after)

POST on /studentSchoolAssociations:

primarySchool: True

enrollmentTypeDescriptor: uri://dpi.wi.gov/EnrollmentTypeDescriptor#P

entryGradeLevelDescriptor: uri://dpi.wi.gov/GradeLevelDescriptor#09

nextYearGradeLevelDescriptor: uri://dpi.wi.gov/GradeLevelDescriptor#10

1.0

Using GradeTypeDescriptor 

Effective the 2026-27SY, the GradeTypeDescriptor has moved all change values to the new ed-fi.org name space. 

POST /grades

1.1

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#First Trimester
periodSequence: 1
schoolId: 7525
schoolyear: 2021
studentSectionAssociationReference:
studentUniqueId: 8660232105
schoolId: 7525
localCourseCode: LCC-121941
sectionIdentifier: Section-121941
schoolYear: 2021,
sessionName: Sessions-121941
gradetypeDescriptor: "uri://ed-fi.org/GradeTypeDescriptor#Final",
performanceBaseConversionDescriptor: uri://dpi.wi.gov/PerformanceBaseConversionDescriptor#P
letterGradeEarned: A
numericGradeEarned: 01

2.0

Using GradeTypeDescriptor (Regression)

Prior 2026-27 SY, this descriptor is sourced from sourced from
 uri://dpi.wi.gov

POST /grades
 

2.1

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 (Regression)

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#First Trimester
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

1.0

Using ContinuationOfServicesReasonDescriptor (Regression)

Effective the 2026-27SY, the ContinuationOfServicesReasonDescriptor has moved all values to the new ed-fi.org name space.

GET from /studentMigrantProgramAssociation

"continuationOfServicesReasonDescriptor": "uri://"uri://ed-fi.org/ContinuationofServicesReasonDescriptor#Ceased to be migratory during school term",
"eligibilityExpirationDate": "2026-06-05",
"endDate": "2026-06-05",

2.0

Using ContinuationOfServicesReasonDescriptor (Regression)

Prior 2026-27 SY, this descriptor is sourced from sourced from
 uri://dpi.wi.gov

GET from /studentMigrantProgramAssociation

"continuationOfServicesReasonDescriptor": "uri://dpi.wi.gov/ContinuationofServicesReasonDescriptor#01",
"eligibilityExpirationDate": "2025-09-05",
"endDate": "2025-09-05",

1.0

Using EligibilityEvaluationTypeDescriptor 

Effective the 2026-27SY, the EligibilityEvaluationTypeDescriptor has moved all values to the new ed-fi.org name space.  

POST on /ssepea

1.1

Sending a school-aged (3-21) student whose evaluation process is completed within in 60 days with no exception.

When parents provide consent for evaluation and the evaluation is completed within the 60-day timeframe, then the that LEA completed the evaluation submits /studentSpecialEducationProgramEligibilityAssociation (SSEPEA)
Prereq:

• LEA has a WISEid for the student and an enrollment record (studentSchoolAssociation) submitted for the student

When the LEA receives a referral to evaluate the student and determine their eligibility for special education services, then the LEA must do the following within 15 business days:

• Send the parents a notice of receipt of referral

• Conduct a review of existing data

• Send the parents either a notice that no additional testing is required or a notice seeking consent to conduct the additional testing.

The 60 calendar day timeline begins either:

• On the date, the district sends the notice that no additional testing is required, or

• On the date, the consent for the additional testing is received by the district

POST on /studentSpecialEducationProgramEligibilityAssociation

},
"consentToEvaluationReceivedDate": "2026-07-02",
"eligibilityDeterminationDate": "2026-07-02",
"eligibilityEvaluationTypeDescriptor": "uri://ed-fi.org/EligibilityEvaluationTypeDescriptor#Initial Evaluation",
"evaluationCompleteIndicator": true,
"evaluationDelayReasonDescriptor": "uri://ed-fi.org/EvaluationDelayReasonDescriptor#Transfer",
"evaluationLateReason": "",
"ideaIndicator": false,
"ideaPartDescriptor": "uri://ed-fi.org/IDEAPartDescriptor#IDEA Part B",
}

2.0

Using EligibilityEvaluationTypeDescriptor (Regression)

Prior 2026-27 SY, this descriptor is sourced from sourced from
 uri://dpi.wi.gov

POST on /ssepea

2.1

Sending a school-aged student whose evaluation was completed beyond the 60-day timeline (Regression)

When parents provide consent for evaluation and the evaluation was completed past the 60-day timeframe, then the LEA completed the evaluation submits /studentSpecialEducationProgramEligibilityAssociation (SSEPEA) and provide a valid Evaluation Delay Reason to the 60-day timeframe that applied or provide at least one Late Reason.

• The Evaluation Delay Reason (i.e. exception) is submitted when the evaluation is not/will not be completed within the statutorily defined 60-day timeline and a State identified exception to this requirement applies.

• The Evaluation Late Reason is submitted when the evaluation is not/will not be completed within the statutorily defined 60-day timeline and a State identified exception to this requirement does NOT apply.

• The Evaluation Late Reason cannot also be supplied when a Evaluation Delay Reason is submitted, and vice versa.

Prereq:

• LEA has a WISEid for the student

• LEA has an enrollment record (studentSchoolAssociation) submitted for the student

POST on /studentSpecialEducationProgramEligibilityAssociation:
consentToEvaluationReceivedDate: 2022-08-01
educationOrganizationReference:
educationOrganizationId: 1139
programReference:
educationOrganizationId: 48856
programName: Special Education
programTypeDescriptor: uri://dpi.wi.gov/ProgramTypeDescriptor#SPED
studentReference:
studentUniqueId: 4272783785
eligibilityDeterminationDate: 2022-10-03
eligibilityEvaluationTypeDescriptor: uri://dpi.wi.gov/EligibilityEvaluationTypeDescriptor#I
evaluationCompleteIndicator: true
evaluationDelayReasonDescriptor: uri://dpi.wi.gov/EvaluationDelayReasonDescriptor#C; OR
evaluationLateReason: “e.g. parent unavailable”
ideaIndicator: true
ideaPartDescriptor: uri://dpi.wi.gov/IDEAPartDescriptor#B

1.0

Sending a student enrollment record when student is expected to transfer

For the 2025-26 SY, When an inter-district transfer is expected, then the LEA should send the existing enrollment record with exitWithdraw Descriptor as ‘ETC’, and the expected transfer school.

If the specific school to which the student is transferring is unknown, send any school within the anticipated transfer district.

Example: If a student is transferring to a high school in Madison but the exact school is unknown, report any high school within Madison.

PUT on /studentSchoolAssociations:
"exitWithdrawDate": "2027-06-05",
"exitWithdrawTypeDescriptor": "uri://dpi.wi.gov/exitWithdrawTypeDescriptor#ETC",
"fullTimeEquivalency": 1.0,
"primarySchool": true,
"NextYearGradeLevelDescriptor": "uri://ed-fi.org/GradeLevelDescriptor#Twelfth Grade",
"schoolChoice": false,
"nextYearSchoolReference": {
"schoolId": 31001,
},
"termCompletionIndicator": true,

2.0

Sending a student enrollment record when student is expected to transfer
(Historical reference, 2024-25 and prior)

For the 2025-26 SY, when an inter-district transfer is expected, then the LEA should send the existing enrollment record with exitWithdraw Descriptor as ‘ETC’, and the expected transfer school.

If the specific school to which the student is transferring is unknown, send any school within the anticipated transfer district.

PUT on /studentSchoolAssociations:

               "exitWithdrawDate": "2018-12-31",

               "exitWithdrawTypeDescriptor": "uri://dpi.wi.gov/ExitWithdrawTypeDescriptor#ETC",

               "primarySchool": true,

               "repeatGradeIndicator": false,

    "_ext": {

      "wi": {

        "expectedTransferLocalEducationAgencyReference": {

          "localEducationAgencyId": 6733

       },

        "expectedTransferSchoolReference": {

          "schoolId": 3710

       },

1.0

Sending graduation status for a students when a student agrees to include graduation status as part of directory information.

Effective 26/27 SY, students will have the ability to participate in sharing graduation status with individuals, employers, and higher education institutions to find and verify Graduation Status via a Wisconsin Credential and Verification Service. This reduces delays traditionally caused by manual verification.

Student participation is determined by the graduationOpt‑out field:

• False = The student has elected to share their graduation status.

  If no response has been provided by the student, the value should remain Null until updated. A Null value indicates no response and graduation status should be shared.

POST on /SAR"_ext": { "wi": { "graduationStatusOptOut": FALSE "CollegeShareOptIn": } }]