API pour agents IA · serveur MCP
Jours fériés, jours ouvrés et ouvrables (2000 à 2027)
Liste les jours fériés d'une année, compte les jours calendaires, ouvrables et ouvrés entre deux dates, ou calcule la date obtenue en ajoutant des jours ouvrés ou ouvrables. Métropole et Alsace-Moselle. Refuse explicitement les cas non gérés (outre-mer, délais juridiques).
- 0,001 $ par calcul réussi
- Gratuit si une information manque
- Sans compte ni clé d’API
À quoi sert cet outil
Quand un utilisateur a besoin des jours fériés d’une année, du nombre de jours ouvrés ou ouvrables d’une période (paie, congés payés, CDD…), ou de la date obtenue après N jours ouvrés.
Exemple réel
Entrée envoyée et vraie réponse du service (partie « resultat »). La réponse complète contient aussi le détail étape par étape, les hypothèses, la version du barème et ses sources.
Entrée
{
"operation": "compter_jours",
"zone": "metropole",
"date_debut": "2026-05-01",
"date_fin": "2026-05-31"
}Réponse
{
"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
}
]
}Une information manque ? Les questions sont gratuites
Vraie réponse du service si votre agent n’envoie que operation : un refus 422 gratuit qui liste, en un seul aller-retour, toutes les questions à poser à l’utilisateur.
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 ?
Cas non gérés (refus gratuit)
Plutôt que de deviner, l’outil refuse gratuitement ces situations, avant tout paiement :
- 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).
Fiabilité et sources officielles
Code déterministe, sans IA générative. Chaque jour férié de 2000 à 2027, en métropole et en Alsace-Moselle, concorde avec le calendrier officiel de l’État (calendrier.api.gouv.fr) et les tableaux de service-public.fr ; les décomptes sont recoupés par une énumération indépendante, jour par jour.
- www.service-public.gouv.fr/particuliers/vosdroits/F2405
- www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000033020901
Pour vérifier un résultat : simulateur ou service officiel.
Utiliser l’outil
Serveur MCP
Outil france_working_days sur https://tax.francestack.fr/mcp (Streamable HTTP).
API HTTP
POST https://tax.francestack.fr/api/calcul/jours-ouvres, 0,001 $ en USDC via x402, encaissé seulement si le calcul réussit.
Schéma complet des champs : /api/calculs et /openapi.json. Configuration : page d’accueil.
Estimation indicative non contractuelle. Vérifier avec le simulateur ou le service officiel.