Panchang API: Hindu Calendar Data for Your App

The Five Elements of Panchang

Panchang literally means "five limbs" - the five astronomical elements that define each day in the Hindu calendar:

API Request

GET https://api.vedika.io/v1/panchang/daily

Query Parameters:
- date: 2025-12-22
- latitude: 19.0760
- longitude: 72.8777
- timezone: Asia/Kolkata

API Response

{
  "date": "2025-12-22",
  "location": {
    "latitude": 19.0760,
    "longitude": 72.8777,
    "timezone": "Asia/Kolkata"
  },
  "sunrise": "07:02:15",
  "sunset": "18:05:42",
  "moonrise": "21:45:30",
  "moonset": "10:15:22",
  "tithi": {
    "name": "Shukla Saptami",
    "number": 7,
    "paksha": "Shukla",
    "startTime": "05:42:18",
    "endTime": "06:15:44+1"
  },
  "nakshatra": {
    "name": "Uttara Bhadrapada",
    "number": 26,
    "pada": 3,
    "lord": "Saturn",
    "startTime": "14:22:00",
    "endTime": "16:45:30+1"
  },
  "yoga": {
    "name": "Shiva",
    "number": 14,
    "startTime": "08:30:00",
    "endTime": "09:45:00+1"
  },
  "karana": {
    "first": {"name": "Vanija", "endTime": "17:15:00"},
    "second": {"name": "Vishti", "endTime": "06:15:44+1"}
  },
  "rahuKaal": {
    "start": "12:33:58",
    "end": "13:56:23"
  },
  "yamaGandam": {
    "start": "08:24:40",
    "end": "09:47:05"
  },
  "gulikaKaal": {
    "start": "10:11:33",
    "end": "11:33:58"
  },
  "abhijitMuhurta": {
    "start": "12:09:58",
    "end": "12:57:58"
  },
  "brahmaMuhurta": {
    "start": "05:14:15",
    "end": "06:08:15"
  },
  "festivals": ["Saphala Ekadashi Prep"],
  "auspiciousTimings": [
    {"name": "Brahma Muhurta", "start": "05:14:15", "end": "06:08:15", "quality": "excellent"},
    {"name": "Abhijit Muhurta", "start": "12:09:58", "end": "12:57:58", "quality": "excellent"}
  ],
  "inauspiciousTimings": [
    {"name": "Rahu Kaal", "start": "12:33:58", "end": "13:56:23"},
    {"name": "Yama Gandam", "start": "08:24:40", "end": "09:47:05"}
  ]
}

Daily Inauspicious Periods

Vedika calculates all inauspicious periods based on exact sunrise:

• Rahu Kaal - ~1.5 hours ruled by Rahu (avoid starting new things)
• Yama Gandam - Ruled by Yama, god of death (avoid travel)
• Gulika Kaal - Saturn's son's period (avoid medicines)
• Dur Muhurta - Generally inauspicious period
• Varjyam - Nakshatra-based inauspicious time

Python Implementation

import requests

def get_panchang(date, lat, lon, tz="Asia/Kolkata"):
    """Get Panchang for a specific date and location"""
    response = requests.get(
        "https://api.vedika.io/v1/panchang/daily",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        params={
            "date": date,
            "latitude": lat,
            "longitude": lon,
            "timezone": tz
        }
    )
    return response.json()

# Get today's Panchang for Mumbai
panchang = get_panchang("2025-12-22", 19.0760, 72.8777)

# Display key information
print(f"Tithi: {panchang['tithi']['name']}")
print(f"Nakshatra: {panchang['nakshatra']['name']}")
print(f"Sunrise: {panchang['sunrise']}")
print(f"Rahu Kaal: {panchang['rahuKaal']['start']} - {panchang['rahuKaal']['end']}")

# Check if current time is auspicious
from datetime import datetime
now = datetime.now().strftime("%H:%M:%S")
for timing in panchang['inauspiciousTimings']:
    if timing['start'] <= now <= timing['end']:
        print(f"⚠️ Currently in {timing['name']} - avoid important work")

Use Cases