School calendar APIAPI calendrier scolaire
API calendrier scolaireSchool calendar API
This API provides access to the start and end dates of French school holidays for the current academic year. Maintained by the French government, it allows websites and applications to integrate holiday dates for the different school zones (A, B, C) and educational levels. It is published as open data via the data.gouv.fr platform and is intended for reuse by developers and organizations needing up-to-date official school vacation schedules across France, without requiring authentication.L’API calendrier scolaire permet d'accéder aux dates de début et de fin des vacances scolaires pour l'année scolaire en cours. ### Que contient l'API calendrier scolaire ? L'API permet d'intégrer (sur un site web ou une application) les dates des vacances scolaires des différentes zones et pour t…
Trust score
How is this computed?Weighted across five axes. Tap a ring for what it measures.
Data schema (7 fields)
Click a field to see example values.
| Fill | Field | Type | Description |
|---|---|---|---|
| 100% | description | text | Name of the school holiday period.description de la période de vacances |
| 100% | population | text | Group affected, e.g. distinguishing students from teachers.population concernée : permet de différencier les dates de début et fin de vacances entre les élèves et les professeurs par exemple |
| 100% | start_dateDate de début | datetime | Start date of the school holiday period.date de début des vacances scolaires |
| 100% | end_dateDate de fin | datetime | End date of the school holiday period.date de fin des vacances scolaires |
| 100% | locationAcadémies | text | Académie (school district) affected by the holiday.académies concernées par les vacances |
| 100% | zones | text | School holiday zone (e.g. Zone A, B or C).zones de vacances scolaires |
| 100% | annee_scolaireAnnee scolaire | text | School year corresponding to the start date.année scolaire de la date de début |
Schema captured from opendatasoft 23 days ago.
Query the data
Pick columns and a sort, then fetch a live preview straight from the source. Choose an API-filterable column (marked ▾) under “Where” to pick from its list of values.
Sample data (5 records)
| description | population | start_date | end_date | location | zones | annee_scolaire |
|---|---|---|---|---|---|---|
| Vacances de la Toussaint | - | 2017-10-20T22:00:00+00:00 | 2017-11-05T23:00:00+00:00 | Bordeaux | Zone A | 2017-2018 |
| Vacances de la Toussaint | - | 2017-10-20T22:00:00+00:00 | 2017-11-05T23:00:00+00:00 | Poitiers | Zone A | 2017-2018 |
| Vacances de Noël | - | 2017-12-22T23:00:00+00:00 | 2018-01-07T23:00:00+00:00 | Besançon | Zone A | 2017-2018 |
| Vacances de Noël | - | 2017-12-22T23:00:00+00:00 | 2018-01-07T23:00:00+00:00 | Clermont-Ferrand | Zone A | 2017-2018 |
| Vacances de Noël | - | 2017-12-22T23:00:00+00:00 | 2018-01-07T23:00:00+00:00 | Dijon | Zone A | 2017-2018 |
Live sample captured at profiling time — values may have changed upstream.
Verification Status
Using the API
Configuration
- Base URL
- https://data.education.gouv.fr/api/explore/v2.1/catalog/datasets/fr-en-calendrier-scolaire
- Format
- openapi
License
- ✓ Redistributable
- ✓ Attribution required
Query examples
curl -s 'https://data.education.gouv.fr/api/explore/v2.1/catalog/datasets/fr-en-calendrier-scolaire/records?limit=20' -H 'Accept: application/json'First 20 records of the dataset as JSON.
Uses the Opendatasoft Explore v2.1 syntax — supports select, where, group_by and order_by.
Rate limits
Dataset
Volume & freshness
License
No license declared upstream.
Source: opendatasoft
Machine-readable & source
Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.