/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.	https://dpi.wi.gov/wise/data-elements/rostertermdescriptor
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)	https://dpi.wi.gov/wise/data-element/edorgid
3.0	schoolYear*	integer	CONDITINALLY REQ'D	CONDITINALLY REQ'D	Key for School Year	https://dpi.wi.gov/wise/data-elements/school-year
4.0	studentUniqueId*	string	CONDITINALLY REQ'D	CONDITINALLY REQ'D	A unique alphanumeric code assigned to a student.	https://dpi.wi.gov/wise/data-elements/WISEid
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.	https://dpi.wi.gov/wise/data-elements/credential-type
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.	https://dpi.wi.gov/wise/data-elements/achievement-category
8.0	graduationStatusOptOut (Added 2026-27 SY)	boolean	Optional	Optional	The student opts out of sharing their graduation status, regardless of completion/earned diploma, upon request. Selection of this Boolean is equivalent to identifying the student as not sharing graduation status using a public website. Valid values Null = No response, share Graduation Status True = Do not share Graduation Status False = Share Graduation Status

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 ( Removed 2026-27 SY)	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 ( Added 2026-27 SY)	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 ( 2026-27 SY)	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. Diploma Type 'R' should be used for successful GED Option #2 completers because these students are granted regular high school diplomas meeting the requirements of §118.33 (1) (a), (d), or (g), Wis. Stats. The achievement category is Diploma Earned.	POST on / studentAcademicRecords: educationOrganizationReference: educationOrganizationId: 16 schoolYearTypeReference: schoolYear: 2026 studentReference: studentUniqueId: 5357536841 termDescriptor: uri://dpi.wi.gov/TermDescriptor#A diplomas: diplomaAwardDate: 2026-06-15 diplomaTypeDescriptor: uri://dpi.wi.gov/DiplomaTypeDescriptor#R achievementCategoryDescriptor: uri://dpi.wi.gov/AchievementCategoryDescriptor#D
2.0	Sending a student academic record for a student who completed high school with a High School Equivalency diploma type	Any high school equivalency credential issued by the State Superintendent under §115.29 (4)(a), Stats. Includes an HSED1 issued to any student who was not granted a diploma by a school board under §118.33(1)(a), (d), or (g), Stats. The achievement category is Diploma Earned.	POST on / studentAcademicRecords: educationOrganizationReference: educationOrganizationId: 16 schoolYearTypeReference: schoolYear: 2026 studentReference: studentUniqueId: 5357536841 termDescriptor: uri://dpi.wi.gov/TermDescriptor#A diplomas: diplomaAwardDate: 2026-06-15 diplomaTypeDescriptor: uri://dpi.wi.gov/DiplomaTypeDescriptor#HSE achievementCategoryDescriptor: uri://dpi.wi.gov/AchievementCategoryDescriptor#D
3.0	Sending a student academic record for a student who completed high school with Other diploma type	Any high school completion credential issued by a school board that is not a diploma meeting the requirements of §118.33 (1) (a), (d), or (g), Stats. Includes any high school completion credential issued to any student who was neither granted a diploma by a school board under §118.33(1)(a), (d), or (g), Stats., nor issued a high school equivalency credential by the State Superintendent under §115.29 (4)(a), Stats. Examples include certificate of completion and certificate of attendance. The achievement category is Certificate Earned.	POST on / studentAcademicRecords: educationOrganizationReference: educationOrganizationId: 16 schoolYearTypeReference: schoolYear: 2026 studentReference: studentUniqueId: 5357536841 termDescriptor: uri://dpi.wi.gov/TermDescriptor#A diplomas: diplomaAwardDate: 2026-06-15 diplomaTypeDescriptor: uri://dpi.wi.gov/DiplomaTypeDescriptor#O achievementCategoryDescriptor: uri://dpi.wi.gov/AchievementCategoryDescriptor#C
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. SIS vendors may post either a single ‘Annual’ studentAcademicRecord or multiple studentAcademicRecords, then use them for CourseTranscripts. SIS vendors may send studentAcademicRecords and courseTranscripts for grade levels 7 and 8, but are not required. When a the student receives a Diploma, an additional SAR with 'Annual' termDescriptor and the diploma details (diploma type & achievement category) must be submitted from the student's most recent enrolled school.	POST on / studentAcademicRecords: educationOrganizationReference: educationOrganizationId: 16 schoolYearTypeReference: schoolYear: 2026 studentReference: studentUniqueId: 5357536841 termDescriptor: uri://dpi.wi.gov/TermDescriptor#T1
	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": } } ] POST on /SAR "_ext": { "wi": { "graduationStatusOptOut": false, }
	Updating an individual student record to set the graduationStatusOptOut flag to True (Opt-out) when the district includes graduation status in directory information.	Student chooses not to participate.	POST on /SAR "_ext": { "wi": { "graduationStatusOptOut": true, }

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":
    }
  }
]