Docs › Dates and calendars

Holidays API

Bank, government and stock market holidays.

Holidays for a year, filterable by kind and state. Each entry says who observes it.

Base URL https://api.dharun.devNo API key600 requests a minuteThis page as Markdown

Holidays in a year

GET/v1/holidays/{year}

Parameter	Description
`year`path, required	Four-digit year.
`type`query	Kind of holiday. clearing days are ones on which the market trades but nothing settles. One of: bank, central_gazetted, central_restricted, market, clearing.
`state`query	State code or name, for example TN or Tamil Nadu.
`month`query	Month number, 1 to 12.

curl

curl "https://api.dharun.dev/v1/holidays/2026?type=market"

JavaScript

const response = await fetch("https://api.dharun.dev/v1/holidays/2026?type=market");
const body = await response.json();
if (!response.ok) throw new Error(body.error.message);
console.log(body.data);

Python

import requests

response = requests.get("https://api.dharun.dev/v1/holidays/2026?type=market", timeout=10)
body = response.json()
if not response.ok:
    raise RuntimeError(body["error"]["message"])
print(body["data"])

Response, with lists and long text shortened

{
  "data": [
    {
      "date": "2026-01-15",
      "weekday": "Thursday",
      "name": "Municipal Corporation Election - Maharashtra",
      "type": "market",
      "region": "NSE equities",
      "states": [
        "*"
      ]
    },
    {
      "date": "2026-01-26",
      "weekday": "Monday",
      "name": "Republic Day",
      "type": "market",
      "region": "NSE equities",
      "states": [
        "*"
      ]
    },
    {
      "date": "2026-02-15",
      "weekday": "Sunday",
      "name": "Mahashivratri",
      "type": "market",
      "region": "NSE equities",
      "states": [
        "*"
      ]
    }
  ],
  "meta": {
    "total": 20,
    "source": {
      "name": "Trading and clearing holidays, NSE equities",
      "url": "https://www.nseindia.com/resources/exchange-communication-holidays",
      "licence": "Official publication",
      "version": "2026",
      "retrieved": "2026-10-13",
      "attribution": "Trading and clearing holidays from the National Stock Exchange of India, capital market segment."
    },
    "note": "Compiled from official notifications. Dates of festivals fixed by moon sighting can change; check the issuing authority before relying on a date."
  }
}

Data source

Bank holidays in India, 2026. Retrieved 2026-10-13. Licence: Official publication. Bank holidays from the Reserve Bank of India holiday matrix, by regional office.

Central government holidays, 2026, 2027. Retrieved 2026-10-13. Licence: Official publication. Gazetted and restricted holidays for central government offices, from the yearly Department of Personnel and Training memorandum.

Trading and clearing holidays, NSE equities, 2026. Retrieved 2026-10-13. Licence: Official publication. Trading and clearing holidays from the National Stock Exchange of India, capital market segment.

Guides

Bank holidays, working days and T+1 settlement dates

Using an AI assistant? Connect the MCP server and it can call this API by itself.