API ドキュメント

祝日 API

年・月を指定して日本の国民の祝日一覧をJSONで返すREST API。振替休日・国民の休日も含みます。カレンダー機能や業務日数計算など、日本向けアプリ開発でよく必要になる機能を切り出しました。

概要

ベースURL

api.tko3servs.com

認証

不要（無料）

レスポンス形式

JSON

データソース：内閣府「国民の祝日について」（cao.go.jp）。1955年以降のデータを収録し、内閣府が更新次第反映します。

エンドポイント

GET /holidays

https://api.tko3servs.com/holidays?year={年}
https://api.tko3servs.com/holidays?year={年}&month={月}

パラメータ

パラメータ	必須	説明
year	必須	西暦4桁（例: `2024`）。1955〜2100の範囲
month	任意	月（1〜12）。省略すると年全体の祝日を返す

レスポンス例

200 OK ?year=2024&month=1

application/json

{
  "year":  2024,
  "month": 1,
  "count": 2,
  "holidays": [
    { "date": "2024-01-01", "name": "元日" },
    { "date": "2024-01-08", "name": "成人の日" }
  ]
}

フィールド	型	説明

仕様メモ

振替休日・国民の休日

内閣府CSVに収録されている振替休日（祝日が日曜の場合の翌月曜）および国民の休日（祝日に挟まれた平日）もそのまま返します。

データの収録範囲

内閣府が公表している範囲（1955年〜通常2〜3年先）のデータを収録しています。それ以外の年を指定すると 404 を返します。

月指定なしの場合

month を省略すると、その年の祝日をすべて返します（通常15〜17件）。

エラー

404

Not Found

指定した年・月の祝日データが存在しません。収録範囲外の年を指定した場合などに返ります。

422

Unprocessable Entity

パラメータの形式が不正です（yearが数値でない、monthが1〜12の範囲外など）。

ライブデモ

年

月（任意）

Response