A P I
祝日 JSON API
内閣府公表の祝日データを date: name 形式の JSON で返します。CORS
対応・認証不要・静的配信のため高速です。
エンドポイント
GET /api/v1/holidays.json
CORS
Access-Control-Allow-Origin: *
データ出典
内閣府「国民の祝日について」
レスポンス例
{
"2026-01-01": "元日",
"2026-01-12": "成人の日",
"2026-02-11": "建国記念の日",
"2026-02-23": "天皇誕生日",
"2026-03-20": "春分の日",
"2026-04-29": "昭和の日",
"2026-05-03": "憲法記念日",
...
} 利用例 — fetch
const res = await fetch( "https://holiday.omikuji.dev" + "/api/v1/holidays.json" ); const map = await res.json(); // 2026年5月3日は祝日か? map["2026-05-03"]; // → "憲法記念日"
提供しているエンドポイント
公開しているのは以下の 3 種類だけです。ここに無いパス(例: /api/v1/holiday.json)は
HTML の 404 ページが返るため、res.json() は失敗します。
- GET /api/v1/holidays.json 掲載している全年ぶん(1955〜2027 年)をまとめて返す
- GET /api/v1/{year}.json
年別。
/api/v1/years/{year}.jsonでも同じ内容を返す。指定できるのは 1955〜2027 年 - GET /api/v1/next.json
次の祝日を
date/name/renkyuで返す(日次更新)