Developers / Reference / Panchang & festivals

Panchang & festivals

scope: panchang

Tithi, nakshatra, choghadiya and regional festival dates for any place on earth.

Your key must hold the panchang scope. Costs are in credits — what is a credit?

Festival calendar

GET /api/v1/festivals/

1.0 credits

Regional Hindu festival dates. No chart needed — optional year and region.

Request

curl https://rajvidya.com/api/v1/festivals/?year=2026&region=MAHARASHTRA \
  -H "X-API-Key: rv_live_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxx"

Response

{
  "festivals": [{"name": "Ganesh Chaturthi", "date": "2026-09-14",
                 "region": "MAHARASHTRA"}]
}

Choghadiya

GET /api/v1/choghadiya/

1.0 credits

Auspicious and inauspicious time bands. Requires chart_id for the location.

Request

curl https://rajvidya.com/api/v1/choghadiya/?chart_id=2317&date=2026-08-20 \
  -H "X-API-Key: rv_live_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxx"

Response

{
  "date": "2026-08-20",
  "day": [{"name": "AMRIT", "start": "06:12", "end": "07:48",
           "quality": "AUSPICIOUS"}]
}

Panchang image

GET /api/v1/panchang/share-image/

1.0 credits

Rendered daily panchang card as an image. Requires chart_id for the location and personalisation.

Request

curl https://rajvidya.com/api/v1/panchang/share-image/?chart_id=2317 \
  -H "X-API-Key: rv_live_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxx"

Response

{
  "image_url": "https://rajvidya.com/media/panchang/card-2317.png"
}

Language

Add lang to any request to get the interpretation text back in that language. This is written interpretation, not machine translation.

English हिन्दी मराठी ગુજરાતી বাংলা தமிழ் తెలుగు संस्कृत Español Português Français Deutsch Русский العربية 日本語繁體中文

Other scopes