WI DPI WISEdata Ed-Fi Docs
/studentAcademicRecords
The Student Academic Record (SAR) represents the cumulative record of academic achievement for a student and is used for reporting high school diplomas.
This endpoint is expected from Choice schools.
Ed-Fi Tech Docs: v5 Student Transcript > StudentAcademicRecord, v3 Student Transcript > StudentAcademicRecord (2024/25 and prior)
Data Properties:
# | Property Name | Data Type | Public (Required/ Optional/ Conditional) | Choice (Required/ Optional/ Conditional) | Business Definition | Data Element Page |
1.0 | termDescriptor* | string | CONDITINALLY REQ'D | CONDITINALLY REQ'D | The term for the session during the school year. | |
2.0 | educationOrganizationId* | big integer | CONDITINALLY REQ'D | CONDITINALLY REQ'D | The identifier assigned to an education organization. Format change from Integer to Big Integer (2025-26 SY and later) | |
3.0 | schoolYear* | integer | CONDITINALLY REQ'D | CONDITINALLY REQ'D | Key for School Year | |
4.0 | studentUniqueId* | string | CONDITINALLY REQ'D | CONDITINALLY REQ'D | A unique alphanumeric code assigned to a student. | |
5.0 | diplomaTypeDescriptor | string | CONDITINALLY REQ'D | CONDITINALLY REQ'D | The type of diploma/credential that is awarded to a student in recognition of his/her completion of the curricular requirements. | |
6.0 | diplomaAwardDate | string | CONDITINALLY REQ'D | CONDITINALLY REQ'D | The month, day, and year on which the student met graduation requirements and was awarded a diploma. | NA |
7.0 | achievementCategoryDescriptor | string | CONDITINALLY REQ'D | CONDITINALLY REQ'D | The category of achievement attributed to the learner. | |
8.0 | graduationStatusOptOut | boolean | Optional | Optional | Indicates whether or not a student chose to opt-out sharing graduation status. Valid values are: True (Yes) |
|
9.0 | collectShareOptIn | boolean | Optional | Optional | Indicator of whether or not the student has agreed to have their Wisconsin College/University enrollment status data shared back to DPI. Valid values are: True (Yes) (Default) |
|
Descriptors:
Namespace | Code Value | Short Description | Long Description |
|---|
Namespace | Code Value | Short Description | Long Description |
|---|---|---|---|
uri://dpi.wi.gov/TermDescriptor ( Removed 2026-27 SY) | A | Annual | Annual |
uri://dpi.wi.gov/TermDescriptor ( Added 2026-27 SY) | Annual | Annual | Annual |
uri://dpi.wi.gov/DiplomaTypeDescriptor | HSE | High school equivalency credential, other than GED | High school equivalency credential, other than GED |
O | Other diploma | Other diploma | |
R | Regular diploma | Regular diploma | |
uri://ed-fi.org/DiplomaTypeDescriptor | High school equivalency credential, other than GED | High school equivalency credential, other than GED | High school equivalency credential, other than GED |
Other diploma | Other diploma | Other diploma | |
Regular diploma | Regular diploma | Regular diploma | |
uri://dpi.wi.gov/AchievementCategoryDescriptor ( Removed 2026-27) | C | Certificate Earned | Certificate Earned |
D | Diploma Earned | Diploma Earned | |
uri://ed-fi.org/AchievementCategoryDescriptor | Certificate Earned | Certificate Earned | Certificate Earned |
Diploma Earned | Diploma Earned | Diploma Earned |
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 a student academic record for a student who completed high school with a Regular diploma type | The term "regular high school diploma" means the standard high school diploma that is awarded to students in the State and that is fully aligned with the State's academic content standards or a higher diploma and does not include a General Educational Development (GED) credential, certificate of attendance, or any alternative award.
| POST on / studentAcademicRecords: |
2.0 | Sending a student academic record for a student who completed high school with a High School Equivalency diploma type |
| POST on / studentAcademicRecords: |
3.0 | Sending a student academic record for a student who completed high school with Other diploma type |
| POST on / studentAcademicRecords: |
4.0 | Updating a student academic record | If the updated data property is a primary key, then vendors will need to insert a new graduationPlan record, then delete the old studentAcademicRecord. If the updated data property is NOT a primary key, then vendors would simply update the data property for an existing studentAcademicRecord. | NA |
5.0 | Sending a student academic record for a student with non-primary enrollment type | studentAcademicRecord from non-primary school enrolment is NOT required | NA |
6.0 | Submit a student academic record without diploma details as a prerequisite for sending courseTranscripts | Course transcripts link to the student academic record for the session in which the course was taken. Therefore, LEAs who like to integrate their SIS with Xello need to send student academic records without the diploma details.
| POST on / studentAcademicRecords: |
| Sending an academic record for a student who allows graduation status sharing. | 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 public website, reducing delays traditionally caused by manual verification. A parent or student (18 or older) who leaves the opt‑out field blank (Null) is considered to have agreed to share the student’s graduation status. 'Null’ = opt‑in. Participation data will be collected on the graduationStatusOptOut (boolean) data property. | POST on /SAR |
| Sending an academic record for a student who does not allow graduation status sharing. | A parent/student (18 or older) who chooses not to have their graduation status to be searchable selects the check box. 'Y’ = opt‑out. | POST on /SAR |
| Sending an academic record for a student who does not allow UW system schools to share transcript data with DPI. | Effective 26/27 SY, students will have the ability to participate in communicating their interest in having UW School enrollment status data (Enrollment status, Degree or certificate earned, Completion date) shared with DPI for the purposes of:
A parent or student (18 or older) who leaves the opt‑out field blank (Null) is considered to not have UW System Schools enrollment status data shared with DPI. 'Null’ = opt‑out. Participation data will be collected on the graduationStatusOptOut (boolean) data property. | POST on /SAR |
| Sending an academic record for a student who allows UW system schools to share transcript data with DPI. | A parent/student (18 or older) who chooses to have their UW School enrollment status data shared with DPI, selects the check box. 'Y’ = opt‑in. Participation data will be collected on the collectShareOptIn (boolean) data property. | POST on /SAR |
JSON Sample:
{
"termDescriptor": "uri://dpi.wi.gov/TermDescriptor#A",
"educationOrganizationReference": {
"educationOrganizationId": 7525,
},
"schoolYearTypeReference": {
"schoolYear": 2026,
},
"studentReference": {
"studentUniqueId": "2181787249",
},
"diplomas": [{
"diplomaTypeDescriptor": "uri://dpi.wi.gov/DiplomaTypeDescriptor#O",
"diplomaAwardDate": "2026-06-16",
"diplomaLevelType": "Cum laude",
"diplomaDescription": "Regular diploma",
"achievementCategoryDescriptor": "uri://dpi.wi.gov/AchievementCategoryDescriptor#NAH",
}],
}
"_ext": {
"wi": {
"graduationStatusOptOut":
"CollegeShareOptIn":
}
}
]
Wisconsin Department of Public Instruction