Docs / Dates and calendars

Today in India API

India's "now" in one call: date, financial year, working days, holidays, market and panchang.

For agents and widgets: the date and time in IST, the financial year, quarter and assessment year, whether today is a bank (per state), market and central government working day, today's holidays, whether the market is open, and with a pincode the sunrise and the day's panchang in brief.

Base URL https://api.dharun.devNo key needed for most600 units a minute, 3000 with a free keyThis page as Markdown

Today in India

GET/v1/today

Without date it is about now, and cached for a minute. The panchang (with pincode) counts as 10 more units.

Parameter	Description
`state`query	State code or name, for example TN or Tamil Nadu.
`pincode`query	Adds sunrise, sunset and the panchang for that place.
`date`query	Another day, YYYY-MM-DD, instead of today.

curl

curl "https://api.dharun.dev/v1/today?state=TN&pincode=600001&utm_medium=docs"

JavaScript

const response = await fetch("https://api.dharun.dev/v1/today?state=TN&pincode=600001&utm_medium=docs");
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/today?state=TN&pincode=600001&utm_medium=docs", timeout=10)
body = response.json()
if not response.ok:
    raise RuntimeError(body["error"]["message"])
print(body["data"])

Try it here

Change the values and send the request from your browser. Needs JavaScript.

Data source

Bank holidays in India, 2026. Retrieved 2026-11-12T00:38:28Z. Licence: Official publication. Bank holidays from the Reserve Bank of India holiday matrix, by regional office.

Trading and clearing holidays, NSE equities, 2026. Retrieved 2026-11-12T00:38:28Z. Licence: Official publication. Trading and clearing holidays from the National Stock Exchange of India, capital market segment.

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.

Using an AI assistant? Connect the MCP server and it can call this API by itself. Want every endpoint on one bench? Open the playground.