API for AI agents · MCP server
French public holidays and working days API (2000-2027)
French public holidays (jours fériés) and working days for mainland France and Alsace-Moselle, 2000-2027: list a year's holidays, count calendar, working (jours ouvrés) and business days (jours ouvrables) between two dates, or add N working days to a date. Labour Code rules (L3133-1, L3134-13), Easter-based dates, holidays worked by the company and extra days off taken into account.
- $0.001 per successful call
- Free if information is missing
- No account, no API key
What it is for
Use when a user needs the French public holidays of a year, the number of working days (jours ouvrés or ouvrables) in a period, for example for payroll, paid leave or a fixed-term contract, or the date reached after N working days.
Real example
Input sent and real service response (the "resultat" part). The full response also contains the step-by-step detail, assumptions, scale version and sources.
Input
{
"operation": "compter_jours",
"zone": "metropole",
"date_debut": "2026-05-01",
"date_fin": "2026-05-31"
}Response
{
"operation": "compter_jours",
"zone": "metropole",
"date_debut": "2026-05-01",
"date_fin": "2026-05-31",
"jours_calendaires": 31,
"jours_ouvrables": 22,
"jours_ouvres": 17,
"feries": [
{
"date": "2026-05-01",
"code": "fete_travail",
"nom": "Fête du Travail (1er mai)",
"jour_semaine": "vendredi",
"chome": true
},
{
"date": "2026-05-08",
"code": "victoire_1945",
"nom": "Victoire 1945 (8 mai)",
"jour_semaine": "vendredi",
"chome": true
},
{
"date": "2026-05-14",
"code": "ascension",
"nom": "Ascension",
"jour_semaine": "jeudi",
"chome": true
},
{
"date": "2026-05-25",
"code": "lundi_pentecote",
"nom": "Lundi de Pentecôte",
"jour_semaine": "lundi",
"chome": true
}
]
}Missing information? The questions are free
Real response if your agent only sends operation: a free HTTP 422 listing, in one round trip, every question to ask the user (in French, ready to use).
zoneLe lieu de travail est-il en Alsace-Moselle (Bas-Rhin, Haut-Rhin ou Moselle), en métropole hors Alsace-Moselle, ou en outre-mer ?date_debutQuelle est la date de début de la période (incluse), au format AAAA-MM-JJ ?date_finQuelle est la date de fin de la période (incluse), au format AAAA-MM-JJ ?
Unsupported cases (refused for free)
Rather than guess, the tool refuses these situations for free, before any payment.
Not supported (refused for free with HTTP 422): overseas departments and territories (outre-mer), years outside the covered range, periods over 10 years, legal or court deadlines (procedural deadline rules differ).
Full list (in French)
- Années hors de 2000 à 2027 : une année future n'est ajoutée qu'après avoir vérifié qu'aucune loi n'a modifié la liste des jours fériés.
- Outre-mer (départements et collectivités) : jour de commémoration de l'abolition de l'esclavage et jours fériés locaux non gérés (les sources officielles ne concordent pas pour Saint-Martin).
- Jours fériés conventionnels ou locaux (Saint-Éloi, Sainte-Barbe, mi-carême…) : non inclus automatiquement, à indiquer dans autres_jours_non_travailles.
- Délais de procédure et délais légaux (règles de report propres, ex. Code de procédure civile art. 641 et 642) : l’outil fait un calcul arithmétique de dates, pas un calcul de délai juridique.
- Période de plus de 10 ans (compter_jours) ; plus de 1 000 jours à ajouter (ajouter_jours).
- Jour de repos hebdomadaire autre que le dimanche pour les jours ouvrables (définition usuelle : lundi à samedi).
Reliability and official sources
Deterministic code, no LLM. Every holiday date 2000-2027 for mainland France and Alsace-Moselle matches the official government calendar (calendrier.api.gouv.fr) and the service-public.fr tables; counts are cross-checked by an independent day-by-day enumeration.
- www.service-public.gouv.fr/particuliers/vosdroits/F2405
- www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000033020901
To check a result: official simulator or service.
Use the tool
MCP server
Tool france_working_days on https://tax.francestack.fr/mcp (Streamable HTTP).
HTTP API
POST https://tax.francestack.fr/api/calcul/jours-ouvres, $0.001 in USDC via x402, settled only if the calculation succeeds.
Full field schema: /api/calculs and /openapi.json. Setup: home page.
Indicative estimate, not legally binding: check with the official simulator or service. Estimation indicative non contractuelle. Vérifier avec le simulateur ou le service officiel.