Panchang API & widget

The same drik computations that power KaalSetu, available for your own site or app. No key required, no sign-up — just keep the attribution link and be reasonable with request volume.

GET /api/public/panchang

Returns the full panchang for a date and location as JSON. CORS is open, so you can call it straight from the browser.

curl "https://kaalsetu.com/api/public/panchang?city=varanasi&date=2026-10-20"

Query parameters

city: City slug, e.g. delhi, mumbai, varanasi. See /panchang for the full list.
lat, lng: Decimal coordinates. Overrides the city's coordinates when both are given.
tz: IANA timezone, e.g. Asia/Kolkata. Defaults to the city's zone.
date: YYYY-MM-DD. Defaults to today in the resolved timezone.

Response shape

{
  "meta": {
    "source": "KaalSetu",
    "method": "drik ganita, Lahiri ayanamsa, sunrise-based day",
    "location": { "place": "Varanasi", "lat": 25.32, "lng": 82.97, "timezone": "Asia/Kolkata" },
    "date": "2026-10-20"
  },
  "panchang": {
    "tithi": { "index": 9, "full": "Shukla Navami", "...": "..." },
    "nakshatra": { "index": 20, "name": "Purva Ashadha", "pada": 2 },
    "yoga": { "name": "Siddhi" },
    "karana": { "name": "Balava" },
    "sunrise": "2026-10-20T06:05:00.000+05:30",
    "sunset": "2026-10-20T17:38:00.000+05:30",
    "rahu_kaal": { "start": "...", "end": "..." }
  }
}

Responses are cached for 30 minutes. Errors return a JSON body with an error field and a 400 or 404 status.

Embeddable widget

A compact live panchang card for your sidebar or temple website. Swap the city slug for any city listed on the city directory.

<iframe
  src="https://kaalsetu.com/embed/panchang?city=delhi"
  title="Today's Panchang"
  width="320"
  height="260"
  style="border:1px solid #e5e0d5;border-radius:12px"
  loading="lazy"
></iframe>

Festival calendar feed

Subscribe to Hindu festivals in Google Calendar, Apple Calendar or Outlook:

https://kaalsetu.com/api/public/calendar/festivals.ics

Curious how the numbers are produced? Read the methodology.