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_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
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
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)
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
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)
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
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
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
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"}
