POST AI agent ready /v1/holidays/list

API des jours fériés – Liste des jours fériés par pays et par année

Renvoie tous les jours fériés pour un pays et une année spécifiés. Chaque jour férié comprend la date, le nom anglais, le nom local et les types (Public, Banque, National, etc.). Prend en charge plus de 100 pays avec les codes de pays ISO 3166-1 alpha-2.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/holidays/list \
  -H "Content-Type: application/json" \
  -d '{"country":"US","year":2026}'

When to use this API

Estimation de la date de livraison

Lors du calcul des dates de livraison estimées pour une commande de commerce électronique, excluez les jours fériés du décompte des jours ouvrables. Récupérez la liste des jours fériés pour le pays de destination et ignorez ces dates dans votre calcul de dates.

Planification des horaires et paie des employés

Marquez automatiquement les jours fériés dans votre système de planification. Calculez les taux d'indemnités de congés payés, empêchez les gestionnaires de planifier des quarts de travail qui chevauchent les jours fériés et générez des rapports de paie précis.

Intégrations de calendrier

Pré-remplissez les applications de calendrier avec les jours fériés du pays de l'utilisateur. Affichez les jours fériés aux côtés des événements personnels et des réunions de travail afin que les utilisateurs puissent planifier leurs jours de congé sans ajouter manuellement chaque jour férié.

Frequently asked questions

Combien de pays sont pris en charge ?

Plus de 100 pays sont pris en charge à l'aide des codes ISO 3166-1 alpha-2. Les principaux pays comme les États-Unis, la Grande-Bretagne, la DE, la FR, le JP, la BR, l'IN, l'AU et la Californie bénéficient tous d'une couverture complète des vacances.

Les jours fériés régionaux ou nationaux sont-ils inclus ?

La réponse se concentre sur les jours fériés nationaux. Les jours fériés régionaux ou spécifiques à un État (comme les jours fériés aux États-Unis) ne sont pas inclus dans la liste par défaut.

Que contient le tableau types ?

Le tableau types classe chaque jour férié. Les valeurs courantes incluent « Public » (jour de congé reconnu par le gouvernement), « Banque » (jour férié), « National » (observance nationale) et « Facultatif » (facultatif ou observance uniquement). Un jour férié peut avoir plusieurs types.

Puis-je consulter les jours fériés des années passées ?

Oui. Vous pouvez interroger les jours fériés pour n'importe quelle année comprise entre 2000 et 2100. Les données historiques sont utiles pour auditer les calculs de paie passés ou pour vérifier le nombre de jours ouvrables dans les périodes précédentes.

Que se passe-t-il si j'omets le paramètre année ?

Le point de terminaison est par défaut l'année civile en cours. Si vous avez besoin de vacances pour l'année suivante (par exemple pour planifier), indiquez explicitement l'année.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.