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).

HTTP 422 · freePOST /api/calcul/jours-ouvres
  • 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.

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.