{"id":"cc031114-c7d5-4d68-8f63-1c8b7e7b4597","type":"API","name":"API calendrier scolaire","slug":"api-calendrier-scolaire","description":"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…","free_access_class":"FREE_NO_AUTH","auth_type":"NONE","homepage_url":"https://www.data.gouv.fr/dataservices/api-calendrier-scolaire","docs_url":"https://www.education.gouv.fr/calendrier-scolaire-100148","repo_url":null,"status":"ACTIVE","verification_state":"STALE","tags":["education"],"logo_url":"https://udata-avatars.s3.rbx.io.cloud.ovh.net/91/b572136a0046e59aa6bb77f16e0520-100.png","primary_source_url":"https://www.data.gouv.fr/dataservices/api-calendrier-scolaire","extraction_confidence":"0.40","created_at":"2026-06-07T22:08:43.788Z","updated_at":"2026-08-13T07:08:45.179Z","last_verified_at":"2026-08-10T03:22:04.390Z","deprecated_at":null,"ranking_score":63,"last_ranked_at":"2026-08-04T11:57:34.094Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":"2026-08-05T17:11:10.048Z","search_vector":"'a':232B 'academ':75B 'academic':211B 'acceder':148B 'access':61B,197B 'accéder':13B 'across':130B,266B 'allow':83B 'allows':219B 'and':201B,221B,235B,248B,255B 'annee':161B 'anné':26B 'api':1A,6A,8B,33B,37B,59B,136A,141A,143B,168B,172B,195B 'applic':47B,86B 'application':182B 'applications':222B 'as':241B 'authent':134B 'authentication':270B 'aux':14B,149B 'b':97B,233B 'by':214B,253B 'c':98B,234B 'calendar':5A,140A 'calendri':2A,9B,34B 'calendrier':137A,144B,169B 'contient':31B,166B 'cour':29B 'cours':164B 'current':74B,210B 'd':12B,39B,147B,174B 'data':107B,243B 'data.gouv.fr':110B,246B 'date':15B,49B,67B,90B,125B,261B 'dates':150B,184B,203B,226B 'de':16B,19B,151B,154B 'debut':152B 'des':21B,50B,53B,156B,185B,188B 'develop':118B 'developers':254B 'differ':93B 'different':229B 'differentes':189B 'différent':54B 'début':17B 'educ':100B,135C 'educational':236B 'en':28B,163B 'end':66B,202B 'et':18B,56B,153B,191B 'fin':20B,155B 'for':208B,227B,251B 'franc':131B 'france':267B 'french':69B,80B,205B,216B 'govern':81B 'government':217B 'holiday':71B,89B,225B 'holidays':207B 'integr':88B 'integrate':224B 'integrer':175B 'intend':114B 'intended':250B 'intégrer':40B 'is':239B,249B 'it':218B,238B 'l':7B,25B,32B,36B,142B,160B,167B,171B 'les':48B,183B 'level':101B 'levels':237B 'maintain':77B 'maintained':213B 'need':121B 'needing':257B 'of':204B 'offici':126B 'official':262B 'open':106B,242B 'organ':120B 'organizations':256B 'ou':45B,180B 'permet':11B,38B,146B,173B 'platform':111B,247B 'pour':24B,57B,159B,192B 'provid':60B 'provides':196B 'publish':104B 'published':240B 'que':30B,165B 'requir':133B 'requiring':269B 'reus':116B 'reuse':252B 'schedul':129B 'schedules':265B 'school':4A,70B,94B,127B,139A,206B,230B,263B 'scolair':3A,10B,23B,27B,35B,52B 'scolaire':138A,145B,162B,170B 'scolaires':158B,187B 'site':43B,178B 'start':64B,200B 'sur':41B,176B 't':193B 'the':199B,209B,215B,228B,245B 'this':194B 'to':198B,223B,260B 'un':42B,177B 'une':46B,181B 'up':259B 'up-to-d':122B 'up-to-date':258B 'vacanc':22B,51B 'vacances':157B,186B 'vacat':128B 'vacation':264B 'via':108B,244B 'web':44B,179B 'websit':84B 'websites':220B 'without':132B,268B 'year':76B,212B 'zone':55B,95B 'zones':190B,231B","popularity_score":"0.0000","maintenance_score":"0.7000","institution_id":"5b86827e-a848-4295-b242-91ac4e71dc2b","institution_type":"GOVERNMENT","country_code":"FR","official_confidence":40,"proof_summary":"official domain (data.gouv.fr) (catalog: api_gouv_fr)","source_seed_url":null,"is_public_sector":true,"published_at":"2026-06-07T22:08:43.788Z","geographic_scope":"NATIONAL","name_en":"School calendar API","description_en":"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.","native_lang":"fr","access_level":"direct","formats":["CSV"],"capability_tier":"live","trust_score":55.75,"access":{"level":"direct","primary":{"kind":"download","label":"Export CSV","method":"GET","url":"https://data.education.gouv.fr/api/explore/v2.1/catalog/datasets/fr-en-calendrier-scolaire/exports/csv","format":"CSV","source":"query_example","runnable":true,"direct":true},"actions":[{"kind":"download","label":"Export CSV","method":"GET","url":"https://data.education.gouv.fr/api/explore/v2.1/catalog/datasets/fr-en-calendrier-scolaire/exports/csv","format":"CSV","source":"query_example","runnable":true,"direct":true},{"kind":"query","label":"List records","method":"GET","url":"https://data.education.gouv.fr/api/explore/v2.1/catalog/datasets/fr-en-calendrier-scolaire/records?limit=20","source":"query_example","runnable":true,"direct":true},{"kind":"query","label":"Select & filter","method":"GET","url":"https://data.education.gouv.fr/api/explore/v2.1/catalog/datasets/fr-en-calendrier-scolaire/records?select=description%2Cpopulation%2Cstart_date&where=description+is+not+null&limit=20","source":"query_example","runnable":true,"direct":true},{"kind":"query","label":"Run verified request","method":"GET","url":"https://data.education.gouv.fr/api/explore/v2.1/catalog/datasets/fr-en-calendrier-scolaire/records?limit=1","source":"probe","runnable":true},{"kind":"spec","label":"OpenAPI spec","method":"GET","url":"https://data.education.gouv.fr/api/v2/swagger.json","source":"openapi","runnable":false},{"kind":"query","label":"API base URL","method":"GET","url":"https://data.education.gouv.fr/api/explore/v2.1/catalog/datasets/fr-en-calendrier-scolaire","source":"base_url","runnable":false},{"kind":"landing","label":"Read the docs","method":"GET","url":"https://www.education.gouv.fr/calendrier-scolaire-100148","source":"docs","runnable":false},{"kind":"landing","label":"Visit homepage","method":"GET","url":"https://www.data.gouv.fr/dataservices/api-calendrier-scolaire","source":"homepage","runnable":false}],"formats":["CSV"]},"maturity":{"entry_id":"cc031114-c7d5-4d68-8f63-1c8b7e7b4597","granularity":"entry","granularity_label":"One unit = one catalog entry. A PROXY for the SCOPE.md §4 ladder, which governs source families, not entries: a family with 400 entries moves this reading 400 times as much as a family with one. Never compare or combine with the source_family reading.","level":"discovered","level_index":1,"level_label":"Discovered","meaning":"Source and metadata recorded","counts_as_coverage":false,"blocked_by":"verified","rungs":[{"level":"discovered","level_index":1,"label":"Discovered","meaning":"Source and metadata recorded","evidence":"membership of the named population the ladder is taken over","counts_as_coverage":false,"met":true,"reached":true,"criterion":"TRUE"},{"level":"verified","level_index":2,"label":"Verified","meaning":"Access tested successfully","evidence":"entries.verification_state = 'VERIFIED'","counts_as_coverage":false,"met":false,"reached":false,"criterion":"entries.verification_state = 'VERIFIED'"},{"level":"profiled","level_index":3,"label":"Profiled","meaning":"Schema, dimensions and licence understood","evidence":"a data profile with at least one field (entry_data_profiles.field_count > 0)","counts_as_coverage":false,"met":true,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_data_profiles p WHERE p.entry_id = entries.id AND COALESCE(p.field_count, 0) > 0)"},{"level":"executable","level_index":4,"label":"Executable","meaning":"Queries run through Commodity","evidence":"entries.capability_tier = 'live' — today's proxy for \"queryable through us\"","counts_as_coverage":true,"met":true,"reached":false,"criterion":"entries.capability_tier = 'live'"},{"level":"joinable","level_index":5,"label":"Joinable","meaning":"Canonical identifiers and concepts mapped","evidence":"a field link to a canonical identifier whose sampled VALUES match its format","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_field_links efl WHERE efl.entry_id = entries.id AND efl.identifier_id IS NOT NULL AND efl.value_status = 'match')"},{"level":"reproducible","level_index":6,"label":"Reproducible","meaning":"Snapshots and transformation evidence retained","evidence":"at least one retained evidence manifest (migration 078)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM evidence_manifests em WHERE em.entry_id = entries.id)"},{"level":"guaranteed","level_index":7,"label":"Guaranteed","meaning":"Monitored against an operational reliability target","evidence":"an active reliability target with a named monitor (migration 096)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_reliability_targets rt WHERE rt.entry_id = entries.id AND rt.is_active = true)"}],"officialness":{"basis":"catalog_inherited","label":"Inherited from the upstream catalog: this item came from a trusted official government catalog, and that provenance — not per-item proof — is the warrant. Its own proof score is below 80 or it matched no registered institution (apps/worker/src/connectors/catalog/qualify-store.ts).","proof_confidence":40,"proven_threshold":80,"institution_id":"5b86827e-a848-4295-b242-91ac4e71dc2b","definition":"CASE WHEN COALESCE(entries.is_public_sector, false) IS NOT TRUE THEN 'not_official' WHEN COALESCE(entries.official_confidence, 0) >= 80 AND entries.institution_id IS NOT NULL THEN 'per_item_proven' ELSE 'catalog_inherited' END"},"source_family":{"key":"www.data.gouv.fr","label":"One unit = one source family, approximated by the serving host of the entry's primary source URL (e.g. bdl.stat.gov.pl). A COMPUTED stand-in for the curated families of SCOPE.md §5, which no table holds yet. A family sits at the highest level any of its entries has reached, because a family is integrated to the depth of its deepest working integration. Never compare or combine with the entry reading."},"generated_at":"2026-08-16T14:12:49.032Z"},"api_details":{"id":"2b9d67ae-4406-448b-81ff-a008158e3acb","entry_id":"cc031114-c7d5-4d68-8f63-1c8b7e7b4597","base_url":"https://data.education.gouv.fr/api/explore/v2.1/catalog/datasets/fr-en-calendrier-scolaire","openapi_url":"https://data.education.gouv.fr/api/v2/swagger.json","graphql_url":null,"api_version":null,"spec_format":"openapi","endpoints_count":null,"endpoints":[],"rate_limit_info":null,"free_tier_limits":null,"ping_url":"https://data.education.gouv.fr/api/explore/v2.1/catalog/datasets/fr-en-calendrier-scolaire/records?limit=1","created_at":"2026-06-07T22:08:43.808Z","updated_at":"2026-06-26T12:30:46.604Z"},"dataset_details":{"id":"6f7282ed-f2f0-4e07-a845-3c17b3296937","entry_id":"cc031114-c7d5-4d68-8f63-1c8b7e7b4597","upstream_issued":null,"upstream_modified":"2026-04-16T15:33:50.839Z","themes":[],"update_frequency":"annual","temporal_start":"2008-12-31T23:00:00.000Z","temporal_end":"2025-12-30T23:00:00.000Z","spatial_coverage":null,"landing_page":null,"license_id":null,"license_raw":null,"has_documentation":false,"has_data_dictionary":false,"has_versioning":false,"source_portal":"opendatasoft","source_portal_url":"https://data.education.gouv.fr","created_at":"2026-06-26T13:49:55.759Z","updated_at":"2026-07-24T20:27:13.055Z","publisher":null,"publisher_url":null,"distributions":[],"license":null},"license":{"id":"lo-2.0","spdx_id":"etalab-2.0","name":"Licence Ouverte 2.0 (France / Etalab)","url":"https://www.etalab.gouv.fr/wp-content/uploads/2017/04/ETALAB-Licence-Ouverte-v2.0.pdf","is_open":true,"is_redistributable":true,"requires_attribution":true,"category":"national","notes":null,"created_at":"2026-06-12T16:29:19.729Z"},"reuse":{"license_id":"lo-2.0","license_name":"Licence Ouverte 2.0 (France / Etalab)","license_url":"https://www.etalab.gouv.fr/wp-content/uploads/2017/04/ETALAB-Licence-Ouverte-v2.0.pdf","commercial_use":{"status":"yes","value":true},"redistribution":{"status":"yes","value":true},"attribution_required":{"status":"yes","value":true},"share_alike":{"status":"no","value":false},"personal_data_warning":{"status":"yes","value":true},"cache_and_mirror":{"status":"yes","value":true},"undetermined":[],"basis":"licence_text","confidence":0.95,"confidence_tier":"high","source_text":"Texte de la licence - le reutilisateur est libre \"de la communiquer, la reproduire, la copier ; de l'adapter, la modifier, l'extraire et la transformer, notamment pour creer des Informations derivees ; de la diffuser, la redistribuer, la publier et la transmettre, de l'exploiter a titre commercial\". Seule obligation : \"mentionner la paternite de l'Information : sa source (a minima le nom du Concedant) et la date de la derniere mise a jour\". Le texte rappelle que le reutilisateur doit respecter \"le cadre legal relatif a la protection des donnees a caractere personnel\". Aucune clause de partage a l'identique n'est imposee.","source_url":"https://github.com/etalab/licence-ouverte/blob/master/LO.md","reviewed_at":null},"license_raw":"http://www.etalab.gouv.fr/wp-content/uploads/2017/04/ETALAB-Licence-Ouverte-v2.0.pdf","latest_check":{"id":"7b123547-215f-49c2-8d1a-b9aba274b7ae","entry_id":"cc031114-c7d5-4d68-8f63-1c8b7e7b4597","status":"VERIFIED","last_checked_at":"2026-08-10T03:22:04.223Z","p50_latency_ms":1892,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-06-08T12:43:16.754Z","updated_at":"2026-08-10T03:22:04.223Z","consecutive_successes":49,"probe_url":"https://data.education.gouv.fr/api/explore/v2.1/catalog/datasets/fr-en-calendrier-scolaire/records?limit=1","probe_method":"GET","probe_http_status":200,"probe_content_type":"application/json; charset=utf-8","probe_succeeded_at":"2026-08-10T03:22:04.223Z"},"data_profile":{"id":"eaedbe39-e0c5-49e8-a69c-e15ea2b6faf7","entry_id":"cc031114-c7d5-4d68-8f63-1c8b7e7b4597","profile_source":"opendatasoft","profile_kind":"dataset","dataset_id":"fr-en-calendrier-scolaire","fields":[{"name":"description","type":"text","label":null,"fill_pct":100,"filterable":true,"description":"description de la période de vacances","description_en":"Name of the school holiday period."},{"name":"population","type":"text","label":null,"fill_pct":100,"filterable":true,"description":"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","description_en":"Group affected, e.g. distinguishing students from teachers."},{"name":"start_date","type":"datetime","label":"Date de début","fill_pct":100,"filterable":true,"description":"date de début des vacances scolaires","description_en":"Start date of the school holiday period."},{"name":"end_date","type":"datetime","label":"Date de fin","fill_pct":100,"filterable":true,"description":"date de fin des vacances scolaires","description_en":"End date of the school holiday period."},{"name":"location","type":"text","label":"Académies","fill_pct":100,"filterable":true,"description":"académies concernées par les vacances","description_en":"Académie (school district) affected by the holiday."},{"name":"zones","type":"text","label":null,"fill_pct":100,"filterable":true,"description":"zones de vacances scolaires","description_en":"School holiday zone (e.g. Zone A, B or C)."},{"name":"annee_scolaire","type":"text","label":null,"fill_pct":100,"filterable":true,"description":"année scolaire de la date de début","description_en":"School year corresponding to the start date."}],"field_count":7,"sample_records":[{"zones":"Zone A","end_date":"2017-11-05T23:00:00+00:00","location":"Bordeaux","population":"-","start_date":"2017-10-20T22:00:00+00:00","description":"Vacances de la Toussaint","annee_scolaire":"2017-2018"},{"zones":"Zone A","end_date":"2017-11-05T23:00:00+00:00","location":"Poitiers","population":"-","start_date":"2017-10-20T22:00:00+00:00","description":"Vacances de la Toussaint","annee_scolaire":"2017-2018"},{"zones":"Zone A","end_date":"2018-01-07T23:00:00+00:00","location":"Besançon","population":"-","start_date":"2017-12-22T23:00:00+00:00","description":"Vacances de Noël","annee_scolaire":"2017-2018"},{"zones":"Zone A","end_date":"2018-01-07T23:00:00+00:00","location":"Clermont-Ferrand","population":"-","start_date":"2017-12-22T23:00:00+00:00","description":"Vacances de Noël","annee_scolaire":"2017-2018"},{"zones":"Zone A","end_date":"2018-01-07T23:00:00+00:00","location":"Dijon","population":"-","start_date":"2017-12-22T23:00:00+00:00","description":"Vacances de Noël","annee_scolaire":"2017-2018"}],"record_count":"2320","data_size_bytes":null,"dataset_count":null,"query_examples":[{"url":"https://data.education.gouv.fr/api/explore/v2.1/catalog/datasets/fr-en-calendrier-scolaire/records?limit=20","curl":"curl -s 'https://data.education.gouv.fr/api/explore/v2.1/catalog/datasets/fr-en-calendrier-scolaire/records?limit=20' -H 'Accept: application/json'","label":"List records","method":"GET","description":"First 20 records of the dataset as JSON."},{"url":"https://data.education.gouv.fr/api/explore/v2.1/catalog/datasets/fr-en-calendrier-scolaire/records?select=description%2Cpopulation%2Cstart_date&where=description+is+not+null&limit=20","curl":"curl -s 'https://data.education.gouv.fr/api/explore/v2.1/catalog/datasets/fr-en-calendrier-scolaire/records?select=description%2Cpopulation%2Cstart_date&where=description+is+not+null&limit=20' -H 'Accept: application/json'","label":"Select & filter","method":"GET","description":"Project specific fields (description, population, start_date) and filter with ODSQL where clauses."},{"url":"https://data.education.gouv.fr/api/explore/v2.1/catalog/datasets/fr-en-calendrier-scolaire/exports/csv","curl":"curl -sL 'https://data.education.gouv.fr/api/explore/v2.1/catalog/datasets/fr-en-calendrier-scolaire/exports/csv' -o dataset.csv","label":"Export CSV","method":"GET","description":"Full dataset export as CSV (also available: json, parquet, xlsx)."}],"status":"ok","error_message":null,"profiled_at":"2026-07-24T20:27:12.577Z","run_id":"93694579-308a-4fd4-bad9-8e0003c18e0a","created_at":"2026-06-12T19:11:03.633Z","updated_at":"2026-07-24T20:27:12.577Z","license_raw":"http://www.etalab.gouv.fr/wp-content/uploads/2017/04/ETALAB-Licence-Ouverte-v2.0.pdf","license_id":"lo-2.0","consecutive_failure_count":0,"last_error_at":null,"last_error_message":null,"previewable":true},"datasets":[],"limits":[{"id":"3e629c6b-c024-466b-b4b0-06a85b05b717","entry_id":"cc031114-c7d5-4d68-8f63-1c8b7e7b4597","limit_type":"requests_per_day","value":"50000","unit":"requests","period":"day","scope":"per-ip","source_id":null,"claim_type":"measured","confidence":"0.90","observed_at":"2026-07-24T20:27:13.216Z"}]}