Esha← Home

Developers

A free panchang API, no key required.

For people building websites or apps: this JSON endpoint powers the same one our own panchang tool and the city pages call. If you only want to read a panchang, use the tool. API use is free within the licence below, with attribution.

Licence: non-commercial projects and editorial content, with attribution

You may use this endpoint in a non-commercial app, script or personal project. You may also write editorial content about the data, including a monetised blog post or newsletter. These uses are free and require no registration. This permission does not grant a licence to sell an API product or cover other commercial product uses. In return, please:

  • Credit Esha with a visible link back to https://askesha.com wherever the data is displayed.
  • Don't resell or repackage this endpoint itself as your own paid API product.
  • Stay within the rate limit below — it keeps the service available for everyone.

This is offered as-is: the endpoint may change shape, and there is no uptime guarantee beyond what the rest of askesha.com gets. If your use case needs a formal commercial licence or a higher rate limit, email support@askesha.com.

The endpoint

curl "https://api.askesha.com/api/v1/tools/panchang?city=Delhi&date=2026-07-09"
ParamRequiredNotes
cityYesA city name (e.g. "Delhi", "London") — matched against Esha's place database.
dateNoYYYY-MM-DD. Defaults to today in the city's local timezone if omitted.

Response shape illustration, not a captured result: the four “...” names are placeholders. The Thursday Rahu kālam example uses the displayed 5.83–19.25 daylight interval, divided into eight parts; its sixth part is 14:13–15:54.

{
  "city": "Delhi",
  "date": "2026-07-09",
  "timezone": "Asia/Kolkata",
  "vara": "Thursday",
  "tithi": { "name": "..." },
  "nakshatra": { "name": "..." },
  "yoga": { "name": "..." },
  "karana": { "name": "..." },
  "rahu_kalam": { "start": "14:13", "end": "15:54" },
  "sunrise_hour": 5.83,
  "sunset_hour": 19.25
}

tithi, nakshatra, yoga, and karana are reported at 12:00 local civil time on the requested date, not solar noon. These values can change during the day. Transition times are not returned, so this snapshot cannot select a ritual time or determine an observance. rahu_kalam is that weekday's window calculated from the city's sunrise/sunset. sunrise_hour/sunset_hour are decimal hours in the city's local time.

Solar times normally use the Sun’s centre at the geometric horizon, without atmospheric refraction. Terrain and buildings are not modelled. If the solar calculation is unavailable, approximate times may be returned without a separate indication here. Check a local almanac before using these times for an observance.

No-code panchang embed

Add the same bounded daily panchang to a temple, community, devotional, or practitioner site with one sandboxed iframe. It refreshes roughly hourly and contains only the date, tithi, nakshatra, yoga, karana, sunrise/sunset, and rahu kalam. Change city to delhi, mumbai, hyderabad, bengaluru, or london; use theme=dark for dark pages.

<iframe src="https://askesha.com/embed/panchang?city=delhi&theme=light&publisher=your-site-slug" title="Daily Panchang by AskEsha" width="100%" height="460" loading="lazy" sandbox="allow-popups allow-popups-to-escape-sandbox" style="border:0;max-width:560px"></iframe>

Replace your-site-slug with a short, non-sensitive identifier for your site. It appears only as the utm_campaign on the followed attribution link. Never put an email address, token, or user id there.

License condition: keep the visible “Panchang by AskEsha” link intact and followed. Do not cover or remove the attribution, and do not add prediction, remedy, medical, financial, newborn, or fear-based copy as though it came from the embed. We may replace a placement with a neutral unavailable notice if its host violates these terms. The embed executes no third-party JavaScript in the host page.

Rate limit and caching

1,000 requests per day per IP address, generous enough for a blog widget or a small app without registering a key. Requests with a date return Cache-Control: public, s-maxage=3600, stale-while-revalidate=600. Requests without a date use today and return Cache-Control: no-store. Always honour the Cache-Control header returned with each response.

What this endpoint does not do

This is a deterministic calendrical calculation — tithi, nakshatra, yoga, karana, and rahu kālam only. It takes no birth details and returns no interpretation, prediction, or personal reading. For chart-based tools (birth chart, kundli matching, dasha), see the free tools — those are POST endpoints designed for a form, not for scripted/automated polling.

Already using it? See it running

The same endpoint powers /tools/panchang and each of these auto-updating city pages: