Course Transcripts (Public LEA Only)

WI DPI WISEdata Ed-Fi Docs

Course Transcripts (Public LEA Only)

In an effort to help integrate Xello’s Course Planner tool with the Student Information System (SIS), DPI has developed an integration that enables Xello to retrieve course transcripts from the WISEdata API and store them back into the Course Planner tool. Course Transcript is an optional integration for SIS vendors. SIS vendors that implemented this integration will send the course transcripts to the WISEdata API, which allows Xello to get the data directly through the WISEdata API instead of relying on flat files and exports. School districts may need to check their SIS Ed-Fi configuration and make sure CourseTranscript and StudentAcademicRecord are enabled.

Course Transcript is the final record of a student's performance in their courses at the end of a semester or school year. Course transcript data is not displayed on the student page in WISEdata Portal, however, school districts may download the Course Transcript export to view what their SIS vendor sent to the WISEdata API.



Data Properties:

#

Property Name

Data Type

Public (Required/ Optional/ Conditional)

Choice (Required/ Optional/ Conditional)

Business Definition

Data Element Page

1.0

courseAttemptResultDescriptor

string

REQ'D

NOT REQ'D

The result from the student's attempt to take the course, for example: Pass Fail Incomplete Withdrawn.

NA

2.0

courseCode

string

OPT

NOT REQ'D

A unique alphanumeric code assigned to a course.

Courses

3.0

educationOrganizationId

integer

REQ'D

NOT REQ'D

The identifier assigned to an education organization.

Education Organization Reference

 

4.0

schoolYear

integer

REQ'D

NOT REQ'D

The identifier for the school year.

NA

5.0

studentUniqueId

string

REQ'D

NOT REQ'D

A unique alphanumeric code assigned to a student.

NA

6.0

termDescriptor

string

REQ'D

NOT REQ'D

The term for the session during the school year.

NA

7.0

alternativeCourseCode

(used by Xello)

string

OPT

NOT REQ'D

The local code assigned by the school that identifies the course offering, the code from an external educational organization, or other alternate course code.

Local Course Code

8.0

alternativeCourseTitle

(used by Xello)

string

OPT

NOT REQ'D

The descriptive name given to a course of study offered in the school, if different from the CourseTitle.

Local Course Title

9.0

AttemptedCredits

number

REQ'D

NOT REQ'D

The value of credits or units of value awarded for the completion of a course.

NA

10.0

earnedCredits

number

OPT

NOT REQ'D

The value of credits or units of value awarded for the completion of a course.

NA

11.0

finalLetterGradeEarned

(used by Xello)

string

CONDITINALLY REQ'D

NOT REQ'D

The final indicator of student performance in a class as submitted by the instructor.

Letter Grade Earned

12.0

finalNumericGradeEarned

(used by Xello)

number

CONDITINALLY REQ'D

NOT REQ'D

The final indicator of student performance in a class as submitted by the instructor.

Numeric Grade Earned

13.0

whenTakenGradeLevelDescriptor

string

REQ'D

NOT REQ'D

Student's grade level at time of course.

NA


Descriptors:

Namespace

Code Value

Short Description

Description

Namespace

Code Value

Short Description

Description

uri://ed-fi.org/CourseAttemptResultDescriptor

Fail

Fail

Fail

Incomplete

Incomplete

Incomplete

Pass

Pass

Pass

Withdrawn

Withdrawn

Withdrawn

uri://dpi.wi.gov/TermDescriptor ( Removed 2026-27)

A

Annual

Annual

S1

1st Semester

1st Semester

S2

2nd Semester

2nd Semester

T1

1st Trimester

1st Trimester

T2

2nd Trimester

2nd Trimester

T3

3rd Trimester

3rd Trimester

Q1

1st Quarter

1st Quarter

Q2

2nd Quarter

2nd Quarter

Q3

3rd Quarter

3rd Quarter

Q4

4th Quarter

4th Quarter

uri://ed-fi.org/TermDescriptor ( Added 2026-27)

Annual

Annual

Annual

 

Fall Semester

Fall Semester

Fall Semester

 

Spring Semester

Spring Semester

Spring Semester

 

First Trimester

First Trimester

First Trimester

 

Second Trimester

Second Trimester

Second Trimester

 

Third Trimester

Third Trimester

Third Trimester

 

First Quarter

First Quarter

First Quarter

 

Second Quarter

Second Quarter

Second Quarter

 

Third Quarter

Third Quarter

Third Quarter

 

Fourth Quarter

Fourth Quarter

Fourth Quarter

uri://dpi.wi.gov/GradeLevelDescriptor ( Removed 2026-27 SY)

7

Seventh Grade

Seventh Grade

8

Eighth Grade

Eighth Grade

9

Ninth Grade

Ninth Grade

10

Tenth Grade

Tenth Grade

11

Eleventh Grade

Eleventh Grade

12

Twelfth Grade

Twelfth Grade

uri://ed-fi.org/GradeLevelDescriptor
( Added 2026-27 SY)

Seventh Grade

Seventh Grade

Seventh Grade

 

Eighth Grade

Eighth Grade

Eighth Grade

 

Ninth Grade

Ninth Grade

Ninth Grade

 

Tenth Grade

Tenth Grade

Tenth Grade

 

Eleventh Grade

Eleventh Grade

Eleventh Grade

 

Twelfth Grade

Twelfth Grade

Twelfth Grade


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 Course Transcripts for all the courses a student has taken as part of their graduation plan, and the student is currently NOT in senior year

When a student is enrolled in the same LEA for grade levels 9-11, then the SIS sends one /courseTranscripts record for all the courses completed by student form previous years (9th-10th gardes) where earned credits and final letter grades are available.

  • At the start of a school year for the 11th grade student, we would expect to see 9th and 10th grade courses.

  • At the end of the first term, the transcript can be updated to include those courses where credits have been earned.

  • At the end of the year, the courses in 11th grade should be then posted.

DPI expects one Course Transcript record from the most recent school in the district that contains the student’s full credit history. The courseTranscript can be sent at any time and should include the data available up to that point.

Prerequisite:

  • Submit the a/studentAcademicRecord (without diploma details) before submitting /courseTranscripts.

  • For an 11th grade student, we expect a single annual studentAcademicRecord with a courseTranscript record that included all courses (regardless of where taken) for 9th, 10th and 11th grades (whenTakenGradeLevel). At the end of 12th grade, it would be 9,10,11,and 12.

  • SIS vendors may post multiple SARs and use them for CourseTranscripts.

  • SIS vendors may send SAR and courseTranscripts records for grade levels 7 and 8, and they can use 'T' course to send Roster data for 7th and 8th grades. but it's NOT required.

POST on / studentAcademicRecords:
educationOrganizationReference:
educationOrganizationId: 7525
schoolYearTypeReference:
schoolYear: 2021
studentReference:
studentUniqueId: 8660232105
termDescriptor: uri://dpi.wi.gov/TermDescriptor#A

POST on /courseTranscripts:
courseAttemptResultDescriptor: uri://ed-fi.org/CourseAttemptResultDescriptor#Pass
courseReference:
courseCode: 10017
educationOrganizationId: 48856
studentAcademicRecordReference:
educationOrganizationId: 7525
schoolYear: 2021
studentUniqueId: 8660232105
termDescriptor: uri://dpi.wi.gov/TermDescriptor#A
alternativeCourseCode: 214
alternativeCourseTitle: Astronomy
attemptedCredits: 0.5
earnedCredits: 17
finalLetterGradeEarned: P
finalNumericGradeEarned: 45
whenTakenGradeLevelDescriptor: uri://dpi.wi.gov/GradeLevelDescriptor#11

courseAttemptResultDescriptor: uri://ed-fi.org/CourseAttemptResultDescriptor#Pass
courseReference:
educationOrganizationId: 48856
courseCode: 10022
studentAcademicRecordReference:
educationOrganizationId: 7525
schoolYear: 2021
studentUniqueId: 8660232105
termDescriptor: uri://dpi.wi.gov/TermDescriptor#S2
alternativeCourseCode: "VSCI0236B2,
alternativeCourseTitle: "ENVIRONMENTAL SCIENCE,
courseTitle: Refer to Courses for Title,
earnedCredits:0.5
finalLetterGradeEarned: P
finalNumericGradeEarned: 22
whenTakenGradeLevelDescriptor: "uri://dpi.wi.gov/GradeLevelDescriptor#10

etc.

2.0

Sending Course Transcripts for all the courses a student has taken as part of their graduation plan, and the student is currently in senior year

When a student is in 12th grade, SIS shoud submit Course Transcripts for all high school courses taken in previous years (9th-11th) where earned credits and final letter grades are available. SIS may send the courses completed by student form the current year (12th grade).

DPI expects one Course Transcript record from the most recent school in the district that contains the student’s full credit history. The courseTranscript can be sent at any time and should include the data available up to that point.

POST on / studentAcademicRecords and /courseTranscripts

For a graduating student, an addition SAR record with diploma information must be submitted with ‘Annual’ term descriptor from the student's most recent enrolled school. In addition to other SAR records with term descriptor other than 'Annual'.

POST on / studentAcademicRecords:
educationOrganizationReference:
educationOrganizationId: 7525
schoolYearTypeReference:
schoolYear: 2021
studentReference:
studentUniqueId: 8660232105
termDescriptor: uri://dpi.wi.gov/TermDescriptor#A
diplomas:
diplomaAwardDate: 2021-06-15
diplomaTypeDescriptor: uri://dpi.wi.gov/DiplomaTypeDescriptor#R
achievementCategoryDescriptor: uri://dpi.wi.gov/AchievementCategoryDescriptor#D

3.0

Sending Course Transcripts for a student with a dropped course

LEA may choose to generate a transcript with final letter grade as 'Withdrawal - W' . Some LEAs don't show dropped course on the transcript based on the timeline of when the student dropped the course.

POST on /courseTranscripts:
courseAttemptResultDescriptor: uri://ed-fi.org/CourseAttemptResultDescriptor#Withdrawn
finalLetterGradeEarned: W

4.0

Sending Course Transcripts for a student who transfered to different schools within the same district (multiple SSA records from same LEA, but different school are expected)

Wisconsin Department of Public Instruction