Skip to end of metadata
Go to start of metadata


The Education Organization Calendar interchange carries school calendar information. It can be used to exchange school calendar data, including instructional days, sessions, and grading periods.

Like all standard Ed-Fi interchanges, this schema references the Ed-Fi Core XSD and can be extended using the Ed-Fi Extensions Framework. See the Ed-Fi Data Standard: Developers' Guide for more information.

Use Cases

The Education Organization Calendar Interchange can be used to:

  1. Exchange dates indicating which days are instructional days, holidays, or teacher-only days.
  2. Exchange session start dates and end dates.

  3. Exchange grading period definitions.

Model Details

The following figure shows a logical view of the Education Organization Calendar Interchange schema:



The following table describes the primary entities of which the Education Organization Calendar Interchange is composed. 


This entity represents the prescribed span of time when an education institution is open, instruction is provided and students are under the direction and guidance of teachers and/or education institution administration. A session may be interrupted by one or more vacations.

GradingPeriodThis entity represents the time span for which grades are reported.
CalendarDateThis entity represents a day in the school calendar.
AcademicWeekThis entity represents the academic weeks for a school year, optionally captured to support analyses.

Extended References

This interchange includes the following Extended References. 

Extended Reference NameDescription
SchoolReferenceRequired. Relates the entity to an educational organization of type school.

Descriptor Dependencies

This interchange references the following Ed-Fi Descriptors, thus requiring them to have been defined using the Descriptors interchange prior to this interchange. For more information on the Ed-Fi Descriptor Pattern, see the Ed-Fi Data Standard - Developers' Guide.

Descriptor NameDescription
CalendarEventDescriptorRequired. This descriptor holds the types of scheduled or unscheduled event for the day (e.g., Instructional day, Teacher only day, Holiday, Make-up day, Weather day, Student late arrival/early dismissal day).

Required. This descriptor defines the name of the period for which grades are reported. The mapping of descriptor values to known Ed-Fi enumeration values is required.




The following link is a ZIP archive containing the XSD for the Education Organization Calendar Interchange v2.0 along with the Ed-Fi Core XSD and a Sample XML Data File:

A ZIP archive containing all v2.0 Ed-Fi Standard Interchange Schema can be found in the Download Directory.


  • No labels