/graduationPlans (Public LEA Only)

The Graduation Plan entity is a plan outlining the required credits, credits by subject, credits by course, and other criteria required for graduation.

This endpoint is NOT expected from Choice schools.

Ed-Fi Tech Docs: v5 Student Enrollment > Graduation Plan,
https://techdocs.ed-fi.org/display/EDFICERT/v3+Student+Enrollment+%3E+Graduation+Plan (2024-25 and prior)

Additional Information about Graduation Requirements: About the Data - Graduation Requirements and Graduation Requirements

Data Properties:

#	Property Name	Data Type	Public (Required/ Optional/ Conditional)	Choice (Required/ Optional/ Conditional)	Business Definition	Data Element Page
1.0	graduationPlanTypeDescriptor*	string	REQ’D	NOT REQ’D	The type of academic plan the student is following for graduation: for example, Minimum, Recommended, Distinguished, or Standard.	Graduation Plan Type
2.0	educationOrganizationId*	big integer	REQ’D	NOT REQ’D	The identifier assigned to an education organization. Format change from Integer to Big Integer (2025-26 SY and later)	Education Organization Reference
3.0	schoolYear*	integer	REQ’D	NOT REQ’D	Key for School Year	School Year (Assignment)
4.0	academicSubjectDescriptor	string	REQ’D	NOT REQ’D	The intended major subject area of the graduation requirement.	Academic Subject NOTE: This list includes descriptors for SIS (CEDS & DPI namespace) and Assessment vendors (Ed-Fi namespace).
5.0	credits	number	REQ’D	NOT REQ’D	The value of credits or units of value awarded for the completion of a course for each subject	Credits
6.0	totalRequiredCredits	number	REQ’D	NOT REQ’D	The total value of credits required by district local policy for Graduation (Usually this will the sum of credits but total credits required by districts can exceed the combination of required subject credits and the additional subject credits) .	Total Required Credits
7.0	communityService	number	REQ’D	NOT REQ’D	Total Hours of Community Service Required for Graduation	Community Service
8.0	civicsExam	boolean	REQ’D	NOT REQ’D	Is passing a civics test a requirement for high school graduation?	Civics Exam
9.0	miscellaneousRequiredCredits	string	REQ’D	NOT REQ’D	Reason for Miscellaneous Required Credits is not zero (0),Limit text to 900 characters	Miscellaneous Required Credits
10.0	nonHsHealthEducationCredits	number	REQ’D	NOT REQ’D	Credits of Health Education Requirement Fulfilled in Grade 7 and/or Grade 8	Non-High School Health Education Credits

Descriptors:

NameSpace	Code Value	Short Description	Long Description

NameSpace	Code Value	Short Description	Long Description
uri://ed-fi.org/GraduationPlanTypeDescriptor	Standard	Standard	Standard
uri://ceds.ed.gov/AcademicSubjectDescriptor	01	English Language and Literature	English Language and Literature
	02	Mathematics	Mathematics
	03	Life and Physical Sciences	Life and Physical Sciences
	04	Social Sciences and History	Social Sciences and History
	05	Visual and Performing Arts	Visual and Performing Arts
	07	Religious Education and Theology	Religious Education and Theology
	08	Physical, Health, and Safety Education	Physical, Health, and Safety Education
	09	Military Science	Military Science
	10	Computer Science	Computer Science
	11	Communications and Audio/Visual Technology	Communications and Audio/Visual Technology
	12	Business and Marketing	Business and Marketing
	13	Manufacturing	Manufacturing
	14	Health Care Sciences	Health Care Sciences
	15	Public, Protective, and Government Services	Public, Protective
	16	Hospitality and Tourism	Hospitality and Tourism
	17	Architecture and Construction	Architecture and Construction
	18	Agriculture, Food, and Natural Resources	Agriculture, Food, and Natural Resources
	19	Human Services	Human Services
	20	Transportation, Distribution, and Logistics	Transportation, Distribution, and Logistics
	21	Engineering and Technology	Engineering and Technology
	22	Miscellaneous	Miscellaneous
	24	World Languages	World Languages
	25	Integrative Learning	Integrative Learning
uri://dpi.wi.gov/AcademicSubjectDescriptor	27	Health	Health
	28	Physical Education	Physical Education
	29	Computer Science	Computer Science
	30	Career Technical Education	Career Technical Education
	31	Personal Finance	Personal Finance
	32	Recommended Elective	Recommended Elective

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 Graduation Plan at the district-level

The same Graduation Plan is sent for all the high schools in the district (except for DOC schools).

POST on /graduationPlans:
educationOrganizationReference:
educationOrganizationId: 1302
graduationSchoolYearTypeReference:
schoolYear: 2021
graduationPlanTypeDescriptor: uri://ed-fi.org/GraduationPlanTypeDescriptor#Standard
totalRequiredCredits: 21.5
creditsBySubjects:
academicSubjectDescriptor: uri://ceds.ed.gov/AcademicSubjectDescriptor#01
credits: 4.5
academicSubjectDescriptor: uri://dpi.wi.gov/AcademicSubjectDescriptor#32
credits: 5.5,
_ext:
wi:
civicsExam: true
communityService: 4.25
miscellaneousRequiredCredits:
ExtraCreditsnonHsHealthEducationCredits: 1.5

2.0

Updating the Graduation Plan

If the updated data property is a primary key, then vendors will need to insert a new graduationPlan record, then delete the old graduationPlan record.

If the updated data property is NOT a primary key, then vendors would simply update the data property for an existing graduationPlan record.

NA

JSON Sample:

{
    "graduationPlanTypeDescriptor": "uri://ed-fi.org/GraduationPlanTypeDescriptor#Standard",
    "educationOrganizationReference": {
      "educationOrganizationId": 7533,
},
    "graduationSchoolYearTypeReference": {
      "schoolYear": 2026,
},
    "creditsByCourses": [],
    "creditsBySubjects": [
      {
        "academicSubjectDescriptor": "uri://ceds.ed.gov/AcademicSubjectDescriptor#01",
        "creditTypeDescriptor": "uri://ed-fi.org/CreditTypeDescriptor#Adult education credit",
        "credits": 3.75
      },      {
        "academicSubjectDescriptor": "uri://ceds.ed.gov/AcademicSubjectDescriptor#02",
        "creditTypeDescriptor": "uri://ed-fi.org/CreditTypeDescriptor#Carnegie unit",
        "credits": 4.00
      },      {
        "academicSubjectDescriptor": "uri://ceds.ed.gov/AcademicSubjectDescriptor#03",
        "creditTypeDescriptor": "uri://ed-fi.org/CreditTypeDescriptor#Carnegie unit",
        "credits": 3.00
      },      {
        "academicSubjectDescriptor": "uri://ceds.ed.gov/AcademicSubjectDescriptor#04",
        "creditTypeDescriptor": "uri://ed-fi.org/CreditTypeDescriptor#Carnegie unit",
        "credits": 3.50
      },      {
        "academicSubjectDescriptor": "uri://ceds.ed.gov/AcademicSubjectDescriptor#05",
        "creditTypeDescriptor": "uri://ed-fi.org/CreditTypeDescriptor#Other",
        "credits": 3.5
      },      {
        "academicSubjectDescriptor": "uri://ceds.ed.gov/AcademicSubjectDescriptor#22",
        "creditTypeDescriptor": "uri://ed-fi.org/CreditTypeDescriptor#Carnegie unit",
        "credits": 4.25
      },      {
        "academicSubjectDescriptor": "uri://ceds.ed.gov/AcademicSubjectDescriptor#24",
        "creditTypeDescriptor": "uri://ed-fi.org/CreditTypeDescriptor#Carnegie unit",
        "credits": 2.25
      },      {
        "academicSubjectDescriptor": "uri://dpi.wi.gov/AcademicSubjectDescriptor#27",
        "creditTypeDescriptor": "uri://ed-fi.org/CreditTypeDescriptor#Other",
        "credits": 1.0
      },      {
        "academicSubjectDescriptor": "uri://dpi.wi.gov/AcademicSubjectDescriptor#28",
        "creditTypeDescriptor": "uri://ed-fi.org/CreditTypeDescriptor#Other",
        "credits": 0.5
      },      { 
       "academicSubjectDescriptor": "uri://dpi.wi.gov/AcademicSubjectDescriptor#29",
        "creditTypeDescriptor": "uri://ed-fi.org/CreditTypeDescriptor#Other",
        "credits": 5.5
      },      {
        "academicSubjectDescriptor": "uri://dpi.wi.gov/AcademicSubjectDescriptor#30",
        "creditTypeDescriptor": "uri://ed-fi.org/CreditTypeDescriptor#Other",
        "credits": 5.5
      },      {
        "academicSubjectDescriptor": "uri://dpi.wi.gov/AcademicSubjectDescriptor#31",
        "creditTypeDescriptor": "uri://ed-fi.org/CreditTypeDescriptor#Other",
        "credits": 5.5
      },      {
        "academicSubjectDescriptor": "uri://dpi.wi.gov/AcademicSubjectDescriptor#32",
        "creditTypeDescriptor": "uri://ed-fi.org/CreditTypeDescriptor#Other",
        "credits": 5.5
      },      {
        "academicSubjectDescriptor": "uri://ceds.ed.gov/AcademicSubjectDescriptor#07",
        "creditTypeDescriptor": "uri://ed-fi.org/CreditTypeDescriptor#Other",
        "credits": 3.95
      }
    ],
    "individualPlan": true,
    "requiredAssessments": [],
    "totalRequiredCredits": 16.5,
    "_ext": {
      "Wi": {
        "civicsExam": true,
        "communityService": 5.25,
        "miscellaneousRequiredCredits": "ExtraCredits",
        "nonHsHealthEducationCredits": 1.5
      }
    }
}