POST AI agent ready /v1/holidays/list

祝日 API - 国と年別の祝日リスト

指定された国および年のすべての祝日を返します。各祝日には、日付、英語名、現地名、種類 (公共、銀行、全国など) が含まれます。 ISO 3166-1 alpha-2 国コードを使用して 100 か国以上をサポートします。

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 か国以上がサポートされています。米国、英国、ドイツ、フランス、日本、ブラジル、インド、オーストラリア、カナダなどの主要国はすべて、完全な休暇をカバーしています。

地域または州の祝日は含まれますか?

回答は国民の祝日に焦点を当てています。地域または州固有の祝日 (米国の州の祝日など) は、デフォルトのリストには含まれません。

type 配列には何が含まれますか?

type 配列は各休日を分類します。一般的な値には、「Public」（政府が認める休日）、「Bank」（銀行休業日）、「National」（国家遵守）、および「Optional」（オプションまたは遵守のみ）が含まれます。休日には複数の種類がある場合があります。

過去数年間の休日を照会できますか?

はい。 2000 年から 2100 年までの任意の年の休日をクエリできます。履歴データは、過去の給与計算を監査したり、前の期間の営業日数を確認したりするのに役立ちます。

year パラメータを省略するとどうなりますか?

エンドポイントのデフォルトは現在の暦年です。来年の休暇が必要な場合 (例: 計画のため)、明示的に年を渡します。

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