French school holidays
List the official school holidays of a French zone, academy or overseas territory for a school year or between two dates, and tell whether a given date is in the holidays, with the next ones, from the open data of the Ministry of Education. La Reunion, Mayotte, the Antilles, Guyane, Polynesia and New Caledonia have their own calendars. Typical uses: add a holiday flag to sales before a forecast, plan staff and transport, avoid works near schools during term time.
fr school_holidaysfr school_holidaysfr is_school_holidayfr is_school_holiday

fr school_holidays <zone> <period>


Description

    The school holidays of a zone for a period: a school year (2025-2026; a single year such as 2026 in New Caledonia and Wallis and Futuna, whose school year follows the calendar) or two dates (2026-01-01/2026-06-30: the holidays that overlap them, 10 years at most). Returns {zone, period, population, count, holidays, source}; each holiday: description (French, as published), kind, start, end, last_day, days, school_year, population, locations

Parameters

    zone:   A, B, C, Corse, an academy (Paris, Lyon, Aix-Marseille, Normandie...) or an overseas territory (La Reunion or 974, Mayotte, Guadeloupe, Martinique, Guyane, Polynesie, Nouvelle-Caledonie, Wallis et Futuna, Saint-Pierre-et-Miquelon); case, accents and hyphens do not matter - String - required
    period:   A school year or from/to dates - String - required
admin
fr school_holidays "La Reunion" "2025-2026"
mentdb
{"zone": "Réunion", "period": "2025-2026", "population": "pupils", "count": 5, "holidays": [{"description": "Vacances après 1ère période", "kind": "term_break", "start": "2025-10-11", "end": "2025-10-27", "last_day": "2025-10-26", "days": 16, "open_ended": false, "school_year": "2025-2026", "population": null, "locations": ["Réunion"]}, {"description": "Vacances d'Été austral", "kind": "austral_summer", "start": "2025-12-19", "end": "2026-01-21", "last_day": "2026-01-20", "days": 33, "open_ended": false, "school_year": "2025-2026", "population": null, "locations": ["Réunion"]}, {"description": "Vacances après 3ème période", "kind": "term_break", "start": "2026-02-28", "end": "2026-03-16", "last_day": "2026-03-15", "days": 16, "open_ended": false, "school_year": "2025-2026", "population": null, "locations": ["Réunion"]}, {"description": "Vacances après 4ème période", "kind": "term_break", "start": "2026-05-02", "end": "2026-05-18", "last_day": "2026-05-17", "days": 16, "open_ended": false, "school_year": "2025-2026", "population": null, "locations": ["Réunion"]}, {"description": "Vacances d'Hiver austral", "kind": "austral_winter", "start": "2026-07-04", "end": "2026-08-18", "last_day": "2026-08-17", "days": 45, "open_ended": false, "school_year": "2025-2026", "population": "Élèves", "locations": ["Réunion"]}], "source": "Calendrier scolaire, Ministere de l'Education nationale (data.education.gouv.fr), Etalab licence 2.0"}
Fixed result from a real call to the school calendar API of data.education.gouv.fr on 2026-11-11: zone C (Paris, Creteil, Versailles, Montpellier, Toulouse) between two dates
admin
fr school_holidays "C" "2026-01-01/2026-04-30"
mentdb
{"zone": "Zone C", "period": "2026-01-01/2026-04-30", "population": "pupils", "count": 3, "holidays": [{"description": "Vacances de Noël", "kind": "christmas", "start": "2025-12-20", "end": "2026-01-05", "last_day": "2026-01-04", "days": 16, "open_ended": false, "school_year": "2025-2026", "population": null, "locations": ["Créteil", "Montpellier", "Paris", "Toulouse", "Versailles"]}, {"description": "Vacances d'Hiver", "kind": "winter", "start": "2026-02-21", "end": "2026-03-09", "last_day": "2026-03-08", "days": 16, "open_ended": false, "school_year": "2025-2026", "population": null, "locations": ["Créteil", "Montpellier", "Paris", "Toulouse", "Versailles"]}, {"description": "Vacances de Printemps", "kind": "spring", "start": "2026-04-18", "end": "2026-05-04", "last_day": "2026-05-03", "days": 16, "open_ended": false, "school_year": "2025-2026", "population": null, "locations": ["Créteil", "Montpellier", "Paris", "Toulouse", "Versailles"]}], "source": "Calendrier scolaire, Ministere de l'Education nationale (data.education.gouv.fr), Etalab licence 2.0"}
An unknown zone (no call is made)
admin
fr school_holidays "Zone D" "2025-2026"
mentdb
ERROR: Sorry, an error appears (unknown zone 'Zone D': A, B, C, Corse, La Reunion, Mayotte, Guadeloupe, Martinique, Guyane, Polynesie, Nouvelle-Caledonie, Wallis et Futuna, Saint-Pierre-et-Miquelon, or an academy (Paris, Lyon, Aix-Marseille, Normandie...)).
A school year must be two years that follow each other
admin
fr school_holidays "A" "2025-2027"
mentdb
ERROR: Sorry, an error appears (the parameter 'period': a school year is two years that follow each other (ex: 2025-2026)).

fr school_holidays <zone> <period> <json_params>


Description

    The school holidays with parameters: population (pupils, teachers or all), timeout_ms (20000), cache (true), endpoint, block_private (false)

Parameters

    zone:   A, B, C, Corse, an academy (Paris, Lyon, Aix-Marseille, Normandie...) or an overseas territory (La Reunion or 974, Mayotte, Guadeloupe, Martinique, Guyane, Polynesie, Nouvelle-Caledonie, Wallis et Futuna, Saint-Pierre-et-Miquelon); case, accents and hyphens do not matter - String - required
    period:   A school year or from/to dates - String - required
    json_params:   The parameters - String - required
admin
fr school_holidays "Mayotte" "2026-2027" "{\"population\": \"all\"}"
mentdb
{"zone": "Mayotte", "period": "2026-2027", "population": "all", "count": 6, "holidays": [{"description": "Vacances de la Toussaint", "kind": "autumn", "start": "2026-10-10", "end": "2026-10-26", "last_day": "2026-10-25", "days": 16, "open_ended": false, "school_year": "2026-2027", "population": null, "locations": ["Mayotte"]}, {"description": "Vacances de Noël", "kind": "christmas", "start": "2026-12-12", "end": "2027-01-11", "last_day": "2027-01-10", "days": 30, "open_ended": false, "school_year": "2026-2027", "population": null, "locations": ["Mayotte"]}, {"description": "Vacances de Carnaval", "kind": "carnival", "start": "2027-02-20", "end": "2027-03-08", "last_day": "2027-03-07", "days": 16, "open_ended": false, "school_year": "2026-2027", "population": null, "locations": ["Mayotte"]}, {"description": "Vacances de Printemps", "kind": "spring", "start": "2027-04-30", "end": "2027-05-18", "last_day": "2027-05-17", "days": 18, "open_ended": false, "school_year": "2026-2027", "population": null, "locations": ["Mayotte"]}, {"description": "Vacances d'Été", "kind": "summer", "start": "2027-07-10", "end": "2027-08-20", "last_day": "2027-08-19", "days": 41, "open_ended": false, "school_year": "2026-2027", "population": "Enseignants", "locations": ["Mayotte"]}, {"description": "Vacances d'Été", "kind": "summer", "start": "2027-07-10", "end": "2027-08-23", "last_day": "2027-08-22", "days": 44, "open_ended": false, "school_year": "2026-2027", "population": "Élèves", "locations": ["Mayotte"]}], "source": "Calendrier scolaire, Ministere de l'Education nationale (data.education.gouv.fr), Etalab licence 2.0"}
An endpoint on an internal address refused by block_private (no call is made)
admin
fr school_holidays "A" "2025-2026" "{\"endpoint\": \"http://127.0.0.1:9\", \"block_private\": true}"
mentdb
ERROR: Sorry, an error appears (the address of the endpoint is internal (loopback, private, link-local, local or multicast): refused by block_private).

fr is_school_holiday <date> <zone>


Description

    Whether a date (YYYY-MM-DD) is in the school holidays of a zone. Returns {date, zone, population, school_holiday (true, false or null), weekend, holiday (the holidays that hold the date, or the open-ended ones, or null), next_holiday (the next ones to start), note, source}. A weekend outside the holidays gives school_holiday false and weekend true. school_holiday is null (never a guessed false) when the date follows an open-ended summer_start and comes before the first holidays of the next school year, or when no holidays of the zone are published after the date; note then says why (null otherwise)

Parameters

    date:   The date YYYY-MM-DD - String - required
    zone:   A, B, C, Corse, an academy (Paris, Lyon, Aix-Marseille, Normandie...) or an overseas territory (La Reunion or 974, Mayotte, Guadeloupe, Martinique, Guyane, Polynesie, Nouvelle-Caledonie, Wallis et Futuna, Saint-Pierre-et-Miquelon); case, accents and hyphens do not matter - String - required
admin
fr is_school_holiday "2025-10-20" "974"
mentdb
{"date": "2025-10-20", "zone": "Réunion", "population": "pupils", "school_holiday": true, "weekend": false, "holiday": {"description": "Vacances après 1ère période", "kind": "term_break", "start": "2025-10-11", "end": "2025-10-27", "last_day": "2025-10-26", "days": 16, "open_ended": false, "school_year": "2025-2026", "population": null, "locations": ["Réunion"]}, "next_holiday": {"description": "Vacances d'Été austral", "kind": "austral_summer", "start": "2025-12-19", "end": "2026-01-21", "last_day": "2026-01-20", "days": 33, "open_ended": false, "school_year": "2025-2026", "population": null, "locations": ["Réunion"]}, "note": null, "source": "Calendrier scolaire, Ministere de l'Education nationale (data.education.gouv.fr), Etalab licence 2.0"}
A date that does not exist (no call is made)
admin
fr is_school_holiday "2026-02-30" "A"
mentdb
ERROR: Sorry, an error appears (the parameter 'date' is not a valid date).

fr is_school_holiday <date> <zone> <json_params>


Description

    The same with parameters: population (pupils, teachers or all), timeout_ms, cache, endpoint, block_private

Parameters

    date:   The date YYYY-MM-DD - String - required
    zone:   A, B, C, Corse, an academy (Paris, Lyon, Aix-Marseille, Normandie...) or an overseas territory (La Reunion or 974, Mayotte, Guadeloupe, Martinique, Guyane, Polynesie, Nouvelle-Caledonie, Wallis et Futuna, Saint-Pierre-et-Miquelon); case, accents and hyphens do not matter - String - required
    json_params:   The parameters - String - required
admin
fr is_school_holiday "2026-08-17" "La Reunion" "{\"population\": \"teachers\"}"
mentdb
{"date": "2026-08-17", "zone": "Réunion", "population": "teachers", "school_holiday": false, "weekend": false, "holiday": null, "next_holiday": {"description": "Vacances après 1ère période", "kind": "term_break", "start": "2026-10-10", "end": "2026-10-26", "last_day": "2026-10-25", "days": 16, "open_ended": false, "school_year": "2026-2027", "population": null, "locations": ["Réunion"]}, "note": null, "source": "Calendrier scolaire, Ministere de l'Education nationale (data.education.gouv.fr), Etalab licence 2.0"}
Fixed result from a real call to the school calendar API of data.education.gouv.fr on 2026-11-11: New Caledonia during the summer: only its first day is published, so the answer is null with a note
admin
fr is_school_holiday "2026-12-28" "Nouvelle-Caledonie"
mentdb
{"date": "2026-12-28", "zone": "Nouvelle Calédonie", "population": "pupils", "school_holiday": null, "weekend": false, "holiday": {"description": "Début des Vacances d'Été", "kind": "summer_start", "start": "2026-12-19", "end": null, "last_day": null, "days": null, "open_ended": true, "school_year": "2026", "population": null, "locations": ["Nouvelle Calédonie"]}, "next_holiday": null, "note": "the holidays 'Début des Vacances d'Été' started on 2026-12-19 and the dataset gives only their first day (not the start of the next school year): the answer is unknown", "source": "Calendrier scolaire, Ministere de l'Education nationale (data.education.gouv.fr), Etalab licence 2.0"}