POST AI agent ready /v1/holidays/list

API государственных праздников — список праздников по странам и годам

Возвращает все праздничные дни для указанной страны и года. Каждый праздник включает дату, английское название, местное название и тип (государственный, банковский, национальный и т. д.). Поддерживает более 100 стран с кодами стран ISO 3166-1 альфа-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

Оценка даты доставки

При расчете предполагаемых дат доставки заказа электронной коммерции исключите праздничные дни из подсчета рабочих дней. Получите список праздников для страны назначения и пропустите эти даты в арифметике дат.

График работы сотрудников и расчет заработной платы

Автоматически отмечайте праздничные дни в своей системе планирования. Рассчитайте ставки заработной платы в праздничные дни, не позволяйте менеджерам планировать смены, совпадающие с официальными праздниками, и создавайте точные отчеты о заработной плате.

Интеграция календаря

Предварительно заполните приложения-календари праздничными днями страны пользователя. Отображайте праздники рядом с личными событиями и рабочими встречами, чтобы пользователи могли планировать выходные без добавления каждого праздника вручную.

Frequently asked questions

Сколько стран поддерживается?

Коды ISO 3166-1 Alpha-2 поддерживаются более чем в 100 странах. Основные страны, такие как США, Великобритания, Германия, Франция, Япония, Бразилия, Индиана, Австралия и Калифорния, имеют полное покрытие праздников.

Включены ли региональные или государственные праздники?

Ответ сосредоточен на национальных государственных праздниках. Региональные или государственные праздники (например, государственные праздники США) не включены в список по умолчанию.

Что содержит массив типов?

Массив типов классифицирует каждый праздник. Общие значения включают «Общественный» (выходной день, признанный правительством), «Банк» (праздничный день), «Национальный» (национальный праздник) и «Необязательный» (необязательный или только праздничный день). Праздник может иметь несколько видов.

Могу ли я запросить отпуск за прошлые годы?

Да. Вы можете запросить праздничные дни для любого года с 2000 по 2100. Исторические данные полезны для аудита прошлых расчетов заработной платы или проверки количества рабочих дней в предыдущих периодах.

Что произойдет, если я опущу параметр года?

Конечная точка по умолчанию соответствует текущему календарному году. Если вам нужны каникулы на следующий год (например, для планирования), укажите год явно.

Get your API key

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