Skip to content
github-actions[bot] edited this page Nov 4, 2026 · 5 revisions

FAQ

Is this official?

No. It is compiled from the Ministry of Education's published calendars. Check the Ministry's site for the authoritative version.

Do I need an API key?

No. The files are public. Fetch them directly.

How often is it updated?

When the Ministry publishes a new or revised calendar. Tentative years can change.

Why does 2023-2024 have a different name from 2026?

Since 2021 the school year runs August to June, so those calendars cover two calendar years.

An event name looks odd or a date looks wrong.

The data is read from PDFs, so mistakes happen. Report it with a link to the source.

What is the licence? Can I use it commercially?

The code is MIT and the compiled data is CC BY 4.0, so you can use and change it with credit. The project stores no Ministry documents, only the dates and names extracted from them, and it does not license the Ministry's own publications. See Licensing.

Can I use this in my app?

Yes. See Using the data in your app. Please keep a note that it is unofficial.

Why is a year missing?

Not every year has been published or found. data/index.json lists exactly what exists.


← Using the data in your app · Next: Where the data comes from →

Clone this wiki locally