国民の祝日：日本

国民の祝日データベースを公開しています。

このサイトについて

当サイトでは、日本の「国民の祝日」を各システムで利用するためのWebインターフェースを提供しています。

国民の祝日APIの概要

提供する機能及び取得可能なデータ

日付を指定しリクエストすることで、指定した日付の国民の祝日の名称及び種別を取得することができます。 下記のようなJSON形式で取得できます。

ケース1) 特定の日付を指定した場合⇒JSONオブジェクト形式で取得

下記は、2020年5月5日を指定した場合の取得データです。 

{
    "date": "2020-05-05",
    "name": "こどもの日",
    "type": "国民の祝日"
}
ケース2) 特定の年・月を指定した場合⇒JSON配列形式で取得

下記は、2020年5月を指定した場合の取得データです。 

[
    {
        "date": "2020-05-03",
        "name": "憲法記念日",
        "type": "国民の祝日"
    },
    {
        "date": "2020-05-04",
        "name": "みどりの日",
        "type": "国民の祝日"
    },
    {
        "date": "2020-05-05",
        "name": "こどもの日",
        "type": "国民の祝日"
    },
    {
        "date": "2020-05-06",
        "name": "振替休日",
        "type": "振替休日"
    }
]

なお、指定された日付または年・月に該当する国民の祝日が存在しない場合は、404 Not Foundを返します。

URI

HTTP/HTTPS両対応

国民の祝日APIのURIは、下記のとおりです。 HTTP/HTTPSどちらのプロトコルを指定しても同じデータが取得できます。 http://api.national-holidays.jp/ https://api.national-holidays.jp/ 使用状況に応じていずれか適切な方をご利用ください。

全データ一括取得

現行の祝日法(昭和23年法律第178号)が施行された1948年(昭和23年)7月20日以降の全データを取得する場合は、 http://api.national-holidays.jp/all を使用します。

特定日データ取得

また、特定の日付のデータを取得する場合は、 http://api.national-holidays.jp/2020-04-29 あるいは http://api.national-holidays.jp/2020/04/29 のように指定します。

その他

その他、「年単位」「月単位」などの指定方法を提供しております。 詳細につきましては、API Documentationを参照してください。

国民の祝日APIの利用について

利用規約

国民の祝日APIは、どなたでもご利用いただけます。 下記の「利用規約」に同意いただいた上で、ご利用ください。

お問い合わせ

このサイトに関するお問い合わせは、下記にて受け付けております。

もどる