NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →
Bank Holidays API

Bank Holidays in Japan

Bank holidays in Japan are determined by the Bank Holidays Law and observed across the Bank of Japan and commercial banks. The schedule covers New Year (January 1–3), Coming of Age Day, National Foundation Day, the Emperor's Birthday, Vernal Equinox, Golden Week (Showa Day, Constitution Memorial Day, Greenery Day, Children's Day), Marine Day, Mountain Day, Respect for the Aged Day, Autumnal Equinox, Sports Day, Culture Day, Labour Thanksgiving Day, plus the year-end bank closure December 31. The Holidays API returns Japanese bank holiday data for any year.

The Japan Bank Holidays API allows you to:

  • List every Japanese bank holiday for a given year
  • Pull historical Japan bank holiday calendars going back to 1980
  • Build settlement, payroll and treasury calendars that respect Japan financial closures
  • Integrate Japan banking holidays into trading, brokerage, or scheduling systems
(4.1)

From 2,430 users

2,400+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
391ms417ms453ms753ms1294ms

Didn't find what you were looking for? Suggest an improvement

Japan Bank Holidays 2025

The table below lists the Japan bank holidays for 2025. Use the API to retrieve the full list for any year between 1980 and 2050.

DateDayHoliday
2025-01-01WednesdayNew Year's Day
2025-01-13MondayComing of Age Day
2025-02-11TuesdayNational Foundation Day
2025-02-23SundayEmperor's Birthday
2025-04-29TuesdayShowa Day
2025-05-03SaturdayConstitution Memorial Day
2025-05-05MondayChildren's Day
2025-08-11MondayMountain Day
2025-11-03MondayCulture Day
2025-12-31WednesdayBank Holiday (Year-End)

Sample 2025 schedule. Some dates — in particular religious dates that follow lunar or Coptic calendars — vary year to year. Call the live API for the authoritative list.

/v1/bankholidays GET

https://api.api-ninjas.com/v1/bankholidays?country=JP

Returns every bank holiday observed in Japan for the specified year. Use the country ISO code JP to retrieve Japan bank closures.

Parameters

  • country  required

    Country name or ISO 3166-2 country code. Use JP for Japan.

  • year  optional premium only

    Calendar year between 1980 and 2050. Defaults to the current year.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON array of objects with the following fields, or an error if the request is unsuccessful.

  • name

    Name of the bank holiday.

  • date

    Date in YYYY-MM-DD format.

  • country

    ISO 3166 alpha-2 country code (e.g. JP).

  • year

    Year of the bank holiday.

Sample Request Live Demo!

country
year premium

Try this endpoint live with a free API key

Instant access — no credit card required.

https://api.api-ninjas.com/v1/bankholidays?country=JP

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
[
    {
      name:"New Year's Day",
      date:"2025-01-01",
      country:"JP",
      year:2025
    },
    {
      name:"Coming of Age Day",
      date:"2025-01-13",
      country:"JP",
      year:2025
    },
    {
      name:"National Foundation Day",
      date:"2025-02-11",
      country:"JP",
      year:2025
    },
    {
      name:"Emperor's Birthday",
      date:"2025-02-23",
      country:"JP",
      year:2025
    },
    {
      name:"Showa Day",
      date:"2025-04-29",
      country:"JP",
      year:2025
    },
    {
      name:"Constitution Memorial Day",
      date:"2025-05-03",
      country:"JP",
      year:2025
    },
    {
      name:"Children's Day",
      date:"2025-05-05",
      country:"JP",
      year:2025
    },
    {
      name:"Mountain Day",
      date:"2025-08-11",
      country:"JP",
      year:2025
    },
    {
      name:"Culture Day",
      date:"2025-11-03",
      country:"JP",
      year:2025
    },
    {
      name:"Bank Holiday (Year-End)",
      date:"2025-12-31",
      country:"JP",
      year:2025
    }
]

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/bankholidays?country=JP&year=2025" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed above, you can still make API calls by using any HTTP request library and following the documentation above.

Bank Holidays in Other Countries

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the Bank Holidays API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • Because every entry is of type BANK_HOLIDAY (banking-relevant closures only), the API is well suited for settlement and clearing calendars (ACH, wire, SWIFT), treasury and cash management, trading platforms, international payment scheduling, and loan interest accrual calendars. For non-banking holidays such as public, religious, and observances, use the Holidays API instead.
  • Call the /v1/bankholidays endpoint with the required country parameter (a country name or, preferably, an ISO 3166-2 code) and an optional year between 1980 and 2050, which defaults to the current year and is a premium feature. To check a single date instead, see the /v1/isbankholiday endpoint, or for non-bank holidays try Public Holidays.
  • It returns a JSON object with is_bank_holiday (true or false), bank_holiday_name (the holiday name when true, otherwise null), the date in YYYY-MM-DD format, and the 2-letter country code, given the required date and country parameters. To find the actual business days around a closure, pair it with the Working Days API.
  • The API covers over 230 countries, regions, and territories, and each array entry includes the name of the bank holiday, its date in YYYY-MM-DD format, the 2-letter ISO 3166 alpha-2 country code, and the year observed. To validate or look up country codes, see the Country API.