POST AI agent ready /v1/holidays/list

公共假期 API - 按国家/地区和年份列出的假期列表

返回指定国家和年份的所有公共假期。每个假期包括日期、英文名称、当地名称和类型（公共、银行、国家等）。支持 100 多个具有 ISO 3166-1 alpha-2 国家/地区代码的国家/地区。

Endpoint

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

在计算电子商务订单的预计交货日期时，请从工作日计数中排除公共假期。获取目的地国家/地区的假期列表，并在日期算术中跳过这些日期。

在您的日程安排系统中自动标记公共假期。计算假期工资率，防止经理安排与法定假期重叠的轮班，并生成准确的工资报告。

在日历应用程序中预先填充用户所在国家/地区的公共假期。将假期与个人活动和工作会议一起显示，以便用户可以计划休息日，而无需手动添加每个假期。

支持多少个国家？

使用 ISO 3166-1 alpha-2 代码支持 100 多个国家/地区。美国、英国、德国、法国、日本、巴西、印度、澳大利亚和加拿大等主要国家/地区均提供完整的假期覆盖。

是否包括地区或州假期？

响应主要集中在国家公共假期。地区或州特定假期（如美国州假期）不包含在默认列表中。

types 数组包含什么？

types 数组对每个假期进行分类。常见值包括“公共”（政府认可的休息日）、“银行”（银行假日）、“国家”（国家遵守）和“可选”（可选或仅遵守）。一个假期可以有多种类型。

可以查询往年的假期吗？

是的。您可以查询从 2000 年到 2100 年任何一年的假期。历史数据对于审核过去的工资计算或验证先前期间的工作日计数非常有用。

如果我省略年份参数会发生什么？

端点默认为当前日历年。如果您需要明年的假期（例如，为了计划），请明确地跳过该年份。

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