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

Bank Holidays in India

Bank holidays in India are days on which banks and financial institutions are officially closed under the Negotiable Instruments Act, 1881. The Reserve Bank of India (RBI) publishes the official list each year, and dates vary slightly between states. Major nationwide bank holidays include Republic Day, Independence Day, Gandhi Jayanti, Diwali, and Holi, alongside regional and religious observances. The Holidays API provides Indian bank holiday data going back to 2005 and forward through 2039.

The India Bank Holidays API allows you to:

  • List every Indian bank holiday for a given year
  • Pull historical India bank holiday calendars going back to 1980
  • Build settlement, payroll and treasury calendars that respect India financial closures
  • Integrate India 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

India Bank Holidays 2025

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

DateDayHoliday
2025-01-26SundayRepublic Day
2025-03-14FridayHoli
2025-04-18FridayGood Friday
2025-08-15FridayIndependence Day
2025-10-02ThursdayGandhi Jayanti
2025-10-20MondayDiwali
2025-12-25ThursdayChristmas Day

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=IN

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

Parameters

  • country  required

    Country name or ISO 3166-2 country code. Use IN for India.

  • 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. IN).

  • 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=IN

Headers

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

Sample Response

JSON
[
    {
      name:"Republic Day",
      date:"2025-01-26",
      country:"IN",
      year:2025
    },
    {
      name:"Holi",
      date:"2025-03-14",
      country:"IN",
      year:2025
    },
    {
      name:"Good Friday",
      date:"2025-04-18",
      country:"IN",
      year:2025
    },
    {
      name:"Independence Day",
      date:"2025-08-15",
      country:"IN",
      year:2025
    },
    {
      name:"Gandhi Jayanti",
      date:"2025-10-02",
      country:"IN",
      year:2025
    },
    {
      name:"Diwali",
      date:"2025-10-20",
      country:"IN",
      year:2025
    },
    {
      name:"Christmas Day",
      date:"2025-12-25",
      country:"IN",
      year:2025
    }
]

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/bankholidays?country=IN&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.