ॐ Developer API

The Panchang, as a clean API

A free, rate-limited REST API for Hindu Panchang, Choghadiya, sunrise/sunset and the key muhurat periods — sidereal (Lahiri), validated against standard almanacs.

Free

with an API key

60 / min

per-IP rate limit

9+

JSON endpoints

Validated

to the minute

Get your API key

No login required — enter an email and your key appears instantly.

No login required. The key is free and rate-limited.

Then send it on every request as the X-API-Key header:

curl -H "X-API-Key: sk_live_YOUR_KEY" \
  "https://shubh.live/api/v1/panchang?lat=28.6139&lon=77.2090&date=2026-06-26"

Base URL & rate limits

https://shubh.live/api/v1

Responses are JSON; times are ISO-8601 with the location's timezone offset (e.g. 2026-06-26T22:23:20+05:30). The free tier allows 60 requests/min per IP; exceeding it returns 429. Please cache (a day's panchang for a location doesn't change). Bulk/combinatorial sweeping without a key is throttled.

Endpoints

GET/api/v1/panchang

The five limbs (Tithi, Nakshatra, Yoga, Karana, Vara) with end-times, plus Paksha, lunar month (with Adhik/leap detection), Vikram Samvat + samvatsara, sidereal Moon/Sun Rashi, and sun/moon timings.

Query parameters

  • lat (required) — latitude, -90 to 90
  • lon (required) — longitude, -180 to 180
  • date (optional) — YYYY-MM-DD (defaults to today)

Example response

{
  "date": "2026-06-26", "tz": "Asia/Kolkata",
  "sunrise": "2026-06-26T05:25:00+05:30",
  "tithi": { "name": "Dwadashi", "number": 12, "paksha": "Shukla", "endsAt": "..." },
  "nakshatra": { "name": "Vishakha", "pada": 3, "endsAt": "..." },
  "yoga": { "name": "Siddha", "endsAt": "..." },
  "moonRashi": { "sa": "Tula", "en": "Libra" },
  "lunarMonth": { "amanta": "Jyeshtha", "isAdhika": false },
  "samvat": { "vikram": 2082, "samvatsara": "Kalayukta" }
}
GET/api/v1/panchang/month

A compact per-day Panchang summary for a whole calendar month with parva markers (Purnima, Amavasya, Sankranti). Useful for calendar grids.

Query parameters

  • lat (required) — latitude
  • lon (required) — longitude
  • year (optional) — e.g. 2026
  • month (optional) — 1-12
GET/api/v1/panchang/festivals

Major Hindu festival dates for a year, each resolved with the correct anchor (udaya / madhyahna / aparahna / pradosh) and validated against standard almanacs.

Query parameters

  • lat (required) — latitude
  • lon (required) — longitude
  • year (optional) — e.g. 2026
GET/api/v1/panchang/ekadashi

Ekadashi observance days for a year (Smarta + Vaishnava, with Parana). Handles normal, vriddhi and kshaya cases.

Query parameters

  • lat (required) — latitude
  • lon (required) — longitude
  • year (optional) — e.g. 2026
  • month (optional) — 1-12 (optional)
GET/api/v1/hora

The 24 planetary horas (day + night) with ruling planet and nature.

Query parameters

  • lat (required) — latitude
  • lon (required) — longitude
  • date (optional) — YYYY-MM-DD
GET/api/v1/eclipses

Solar and lunar eclipses for a year, with visibility at the location.

Query parameters

  • lat (required) — latitude
  • lon (required) — longitude
  • year (optional) — e.g. 2026
GET/api/v1/muhurat

Auspicious dates for an activity (vivah, griha-pravesh, vehicle, shubh) in a date range.

Query parameters

  • activity (required) — vivah | griha-pravesh | vehicle | shubh
  • lat (required) — latitude
  • lon (required) — longitude
  • from (optional) — YYYY-MM-DD
  • to (optional) — YYYY-MM-DD
GET/api/v1/day-periods

Rahu Kaal, Yamaganda, Gulika Kaal and Abhijit Muhurat, each with start/end.

Query parameters

  • lat (required) — latitude
  • lon (required) — longitude
  • date (optional) — YYYY-MM-DD
GET/api/v1/choghadiya

The 16 Choghadiya segments (8 day + 8 night) with type, timing and goodFor activities.

Query parameters

  • lat (required) — latitude
  • lon (required) — longitude
  • date (optional) — YYYY-MM-DD
GET/api/v1/sun

Sunrise and sunset for a location and date.

Query parameters

  • lat (required) — latitude
  • lon (required) — longitude
  • date (optional) — YYYY-MM-DD

Accuracy & conventions

  • Sidereal positions use the Lahiri (Chitrapaksha) ayanamsa, computed at local sunrise.
  • Lunar month and Vikram Samvat use the Amanta / Gujarati (Kartik) reckoning.
  • Validated against standard Vedic almanacs across 40+ dates; Tithi/Nakshatra/Yoga match to the minute.
  • Moonrise/moonset are accurate to a few minutes (horizon-model dependent).

Terms

Free for personal and commercial use. Please don't abuse the rate limit, and attribute “Powered by ShubhAI (shubh.live)” where practical. Provided as-is, for informational purposes; not a substitute for a qualified astrologer.