POST/api/astro/panchanga/1 क्रेडिट

पंचांग

पंचांग किसी एक स्थान पर किसी एक क्षण का हिंदू पंचांग है: पाँच 'अंग' — तिथि, वार, नक्षत्र, योग और करण — और वह सब कुछ जो छपे पंचांग में होता है। सत्तावन keys के साथ यह API का सबसे बड़ा एंडपॉइंट है, और ज़्यादातर लोग इनमें से गिनी-चुनी keys ही इस्तेमाल करते हैं। पाँच अंगों के लिए tithi, vaara, nakshatra_segments, yogam और karana से शुरू करें, और दिन के ढाँचे के लिए day_length, night_length, midday और midnight से। *_segments keys — tithi_segments, karana_segments, yoga_segments, nakshatra_segments — अपनी एकवचन keys से एक ऐसी बात में अलग हैं जिसमें गलती आसानी से हो जाती है: एकवचन key बताती है कि 'इस क्षण क्या चल रहा है', जबकि segments key पूरे स्थानीय कैलेंडर दिन में पड़ने वाली हर अवधि को सटीक आरंभ और अंत समय के साथ देती है, और कैलेंडर पेज को यही चाहिए। बाकी keys कुछ समूहों में आती हैं। समय के विभाजन: choghadiya और gauri_choghadiya आठवें भागों में, hora ग्रह होराओं में, do_ghati तीस मुहूर्तों में, trikalam तिहाई भागों में। नाम वाली अवधियाँ: एक ओर abhijit_muhurta, brahma_muhurta, vijaya_muhurta, nishita_muhurta, godhuli_muhurta, amrit_kalam और दोनों संध्याएँ, दूसरी ओर rahu_kaalam, yamaganda_kaalam, gulika_kaalam और durmuhurata। कैलेंडर: lunar_month और lunar_month_poornima (दोनों गणना पद्धतियों में वही महीना), shaka_samvat, vikram_samvat, kali_samvat, samvatsara_name, ritu, sankranti_dates और tamil_solar_month_date। समय नहीं, स्थितियाँ: upagraha_longitudes, special_longitudes, lagnas, sree_lagna और bhaava_madhya के दोनों रूप। दिन कैसा है, इसके फ़ैसले: tarabala, chandrabalam, panchaka_rahita, disha_shool, agni_vasa_segments, shiva_vasa_segments, yogas और shunya_nakshatra। हर कॉल में date_time और timezone_as_float चाहिए, और जो कुछ सूर्योदय पर निर्भर है, उसके लिए अक्षांश और देशांतर भी। कई वैकल्पिक फ़ील्ड केवल फ़ॉर्मैट नहीं, उत्तर ही बदल देते हैं: samvatsara_name के लिए samvata_type ज़रूरी है, mode तय करता है कि ritu कैसे निकाली जाए, और gulika_rises_at, mandi_rises_at, gulika_portion, mandi_portion, kala_mrityu_rise_at और dhuma_vyatipata_relation उपग्रहों की स्थितियों के लिए अलग-अलग शास्त्रीय परिपाटियों में से एक चुनते हैं। आप चाहे जितनी keys माँगें, एक कॉल का शुल्क एक क्रेडिट ही है, इसलिए पूरे पेज के लिए ज़रूरी keys एक साथ माँगें।

https://api.occultapi.com/api/astro/panchanga/

अनुरोध आज़माएँ

पंचांग का नतीजा, एक इंटरफ़ेस में — इस एंडपॉइंट का डेटा एक चालू इंटरफ़ेस में। API सिर्फ़ मान लौटाता है; उन्हें कैसे दिखाना है, यह आप तय करते हैं।

ऑथेंटिकेशन

अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

अनुरोध के फ़ील्ड

फ़ील्ड	टाइप	ज़रूरी	टिप्पणी
date_time	string (date-time)	ज़रूरी	जिस क्षण की गणना करनी है, ISO 8601 फ़ॉर्मैट में। ऑफ़सेट या अंत में Z हमेशा लगाएँ - बिना ज़ोन वाली वैल्यू UTC नहीं, बल्कि Asia/Kolkata (UTC+05:30) मानी जाती है, और तब 200 के साथ पिछले दिन का नतीजा मिल सकता है। '2026-09-01T06:00:00Z' और '2026-09-01 06:00:00' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं।
keys	array	ज़रूरी	कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें।
timezone_as_float	number (double)	ज़रूरी	स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए। min -12 · max 14
dhuma_vyatipata_relation	string	वैकल्पिक	`360_minus_dhumadhuma_plus_53_20` डिफ़ॉल्ट '360_minus_dhuma'। आगे भेजा जाता है।
eccentric_anomaly	number (double)	वैकल्पिक
eccentricity	number (double)	वैकल्पिक
gulika_portion	string	वैकल्पिक	`saturneighth` डिफ़ॉल्ट 'saturn'। आगे भेजा जाता है।
gulika_rises_at	string	वैकल्पिक	`beginningmiddleend` डिफ़ॉल्ट 'beginning'। Panchanga इंजन ऑब्जेक्ट को आगे भेजा जाता है।
kala_mrityu_rise_at	string	वैकल्पिक	`beginningmiddleend` डिफ़ॉल्ट 'middle'। आगे भेजा जाता है।
latitude	number (double)	वैकल्पिक	स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -89.9 · max 89.9
longitude	number (double)	वैकल्पिक	स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180
mandi_portion	string	वैकल्पिक	`saturneighth` डिफ़ॉल्ट 'saturn'। आगे भेजा जाता है।
mandi_rises_at	string	वैकल्पिक	`beginningmiddleend` डिफ़ॉल्ट 'middle'। आगे भेजा जाता है।
mean_anomaly	number (double)	वैकल्पिक
mode	string	वैकल्पिक	`vedicdrik` केवल 'ritu' key इसे इस्तेमाल करती है। 'vedic' ऋतु को चांद्र मास से निकालता है, 'drik' सूर्य की सायन राशि से। इंजन का डिफ़ॉल्ट 'drik' है। चेतावनी: गलत वैल्यू पर फ़ंक्शन त्रुटि नहीं देता - कोई भी दूसरी स्ट्रिंग चुपचाप दोनों शाखाओं से निकल जाती है और key null लौटाती है (कैटलॉग में दिया गया सैंपल भी mode=0 भेजता है और उसे 200 के साथ null परिणाम मिलता है)।
nakshatras	string	वैकल्पिक	`special` इंजन में इसकी इकलौती सार्थक वैल्यू शाब्दिक स्ट्रिंग 'special' है, जो 27 प्रविष्टियों वाली `nakshatras` तालिका की जगह 28 प्रविष्टियों वाली `nakshatras_special` तालिका लगा देती है, जिसमें अभिजित शामिल है और आधुनिक वर्तनियाँ हैं। चूँकि यह कभी आगे नहीं भेजा जाता, इस एंडपॉइंट की 'yogas' key अभी "'Panchanga' object has no attribute 'nakshatras'" के साथ 500 देती है।
samvata_type	string	वैकल्पिक	`shakavikram` केवल 'samvatsara_name' key इसका इस्तेमाल करती है।
tolerance	number (double)	वैकल्पिक

उपलब्ध keys (57)

आपको जो गणनाएँ चाहिए, बस उन्हीं के नाम keys में लिखें। कोई एक भी अनजान नाम हुआ तो पूरा अनुरोध लौटा दिया जाता है। आप कितनी भी गणनाएँ माँगें, शुल्क 1 क्रेडिट ही लगता है — इसलिए सब एक साथ माँगें।

Key	और कौन-से फ़ील्ड चाहिए	विवरण
abhijit_muhurta	—	अभिजित: दिन के पंद्रह मुहूर्तों में से आठवाँ, जो दिनमान के मध्य बिंदु के दोनों ओर फैला होता है — हर काम के लिए शुभ मानी जाने वाली अवधि। {start, end} लौटाती है।
agni_vasa_segments	—	अग्नि देवता का वास कहाँ माना जाता है — होम से पहले की जाने वाली जाँच। यह तिथि और वार से निकलता है, इसलिए तिथि बदलते ही बदल जाता है। {state, is_patala, start_time, end_time} की सूची लौटाती है, दिन के हर तिथि खंड के लिए एक, जहाँ state 'Prithvi (Earth)', 'Akasha (Heaven)' या 'Patala (Nadir)' होता है। किसी मनचाहे फल के लिए किया जाने वाला होम तब करना चाहिए जब अग्नि पृथ्वी पर हो; is_patala उस स्थिति को चिह्नित करता है जिसे कुछ पंचांग भद्रावास कहते हैं।
amrit_kalam	—	दिन में पड़ने वाली, गौरी पंचांगम् की Amrit प्रकार की अवधियाँ — उस तालिका की सबसे अनुकूल पंक्तियाँ। {start, end} की सूची लौटाती है, आमतौर पर दो: एक दिन में और एक रात में। ये gauri_choghadiya वाली वार तालिकाओं से ही निकाली जाती हैं, और कुछ दूसरे पंचांगों की नक्षत्र-आधारित अमृत घटी से इनका कोई संबंध नहीं।
bhaava_madhya_sripati	—	बारह कस्प, bhaava_madhya_swe वाले ही {degree, sign, minutes, seconds, nakshatra, pada} ढाँचे में। शास्त्रीय रूप से Sripati पद्धति चतुर्थांश विभाजन है, पर यह इम्प्लीमेंटेशन उससे केवल लग्न लेता है और फिर बार-बार तीस अंश जोड़ता जाता है, इसलिए किसी भी क्षण के लिए यह bhaava_madhya_swe वाले ही बारह मान लौटाती है।
bhaava_madhya_swe	—	निरयन राशिचक्र में समान भाव पद्धति पर बारह भाव कस्प, पहले भाव से शुरू। बारह ऑब्जेक्ट की सूची लौटाती है, हर एक {degree, sign, minutes, seconds, nakshatra, pada}, जहाँ sign दो अक्षरों का संक्षिप्त रूप है, जैसे 'Ar' या 'Cp'।
brahma_muhurta	—	ब्रह्म मुहूर्त: सूर्योदय से पहले रात के अंतिम दो मुहूर्त, हर एक रात्रिमान का पंद्रहवाँ भाग — अध्ययन, प्रार्थना और ध्यान का पारंपरिक समय। {start, end} लौटाती है।
calcualte_special_tithi	—	तिथि, उसके शास्त्रीय विशेष नामों के साथ: tithi key वाला ही ऑब्जेक्ट, और साथ में special_name फ़ील्ड। इसमें उस दिन की तिथि पर लागू होने वाले सभी लेबल कॉमा से अलग करके एक स्ट्रिंग में होते हैं, या कोई लागू न हो, तो null। व्यवहार में वही लेबल लगते हैं जो सूर्योदय या मध्याह्न पर तिथि के चालू होने से जुड़े हैं (Udayayvapini, Madhyanaha), और अमावस्या वाले लेबल (Sinivaali, Vriddhigami); अंदर की तालिका की कई प्रविष्टियाँ तेलुगु तिथि नामों से जुड़ी हैं, जिन्हें इस एंडपॉइंट की अपनी तिथि गणना बनाती ही नहीं, इसलिए वे कभी मेल नहीं खातीं। ध्यान दें कि key के नाम की वर्तनी में अक्षर उलटे-पलटे हैं, ठीक जैसे दिख रहे हैं।
chandrabalam	—	चंद्रबल: दिन की कौन-सी उदय राशियाँ चंद्रमा की वर्तमान राशि के हिसाब से अच्छी स्थिति में हैं, और इसलिए कोई काम शुरू करने के लिए अनुकूल हैं। राशि नामों की सूची मेष से मीन के क्रम में लौटाती है, आमतौर पर बारह में से छह; ये अगले सूर्योदय से पहले शुरू होने वाली udaya_lagna_muhurta अवधियों से ली जाती हैं।
choghadiya	—	चौघड़िया अवधियाँ: दिनमान और रात, दोनों आठ बराबर भागों में बँटे हैं, और उनके नाम एक चक्र में आते हैं जो उस वार के अपने चौघड़िया से शुरू होता है। {day_choghadiyas, night_choghadiyas, current_choghadiya, day_periods, night_periods} लौटाती है। दोनों नाम-सूचियों में आठ-आठ प्रविष्टियाँ होती हैं — सात नामों का चक्र, दिन के शुरुआती नाम से घुमाया हुआ, और वही नाम अंत में दोबारा — day_periods और night_periods यही आठ {name, start, end} के रूप में देते हैं, और current_choghadiya वह नाम है जिसकी अवधि में माँगा गया क्षण पड़ता है।
day_length	—	माँगा गया क्षण जिस दिन में पड़ता है, उस दिन सूर्योदय से सूर्यास्त तक की अवधि, सेकंड में। यह संख्या नहीं, JSON स्ट्रिंग के रूप में मिलती है - "48927.0" - इसलिए गणना से पहले इसे पार्स करें। इस एंडपॉइंट की दिन को बाँटने वाली ज़्यादातर वैल्यू — choghadiya, hora, rahu_kaalam, दिन के मुहूर्त — इसी आँकड़े के आठवें, बारहवें या पंद्रहवें भाग हैं।
disha_shool	—	वह दिशा जिसकी ओर आज यात्रा से बचना चाहिए; यह केवल वार पर निर्भर है। एक स्ट्रिंग: East, South, West, North, या चार उपदिशाओं में से एक।
do_ghati	—	तीस मुहूर्तों की पूरी तालिका — पंद्रह सूर्योदय से सूर्यास्त तक, और पंद्रह सूर्यास्त से अगले सूर्योदय तक। {day_muhurtas, night_muhurtas, current} लौटाती है। हर मुहूर्त {index, number, muhurta, auspicious, name, division, special, start, end} है: muhurta अधिष्ठाता देवता है, number पूरे दिन-रात में उसका स्थान (1-30), name उससे जुड़ा नक्षत्र, division दिन का हिस्सा (Pratah, Sangava, Madhyahna आदि), auspicious एक बूलियन, और special अभिजित जैसी नाम वाली अवधियों को चिह्नित करता है। current वह प्रविष्टि है जिसमें माँगा गया क्षण आता है, या null।
durmuhurata	—	दुर्मुहूर्त: दिन की एक या दो छोटी प्रतिकूल अवधियाँ। {first, second, interval} लौटाती है, जहाँ first और second ISO टाइमस्टैम्प हैं; जिन वारों में दुर्मुहूर्त एक ही होता है, उनमें second null होता है। `interval` हर दुर्मुहूर्त की लंबाई सेकंड में है, और यहाँ की दूसरी अवधियों की तरह JSON स्ट्रिंग है - सामान्य 48 मिनट के लिए "2880.0"। ध्यान दें कि सूर्योदय से इनकी दूरी वार की तालिका से ली गई तय घड़ी-घंटे हैं, दिनमान के अनुपात वाले भाग नहीं।
eccentric_anomaly	mean_anomaly, eccentricity, tolerance	ज्योतिषीय मान नहीं, बल्कि कक्षीय यांत्रिकी का एक सामान्य सहायक: न्यूटन पुनरावृत्ति (Newton iteration) से केप्लर का समीकरण हल करती है। mean_anomaly (अंशों में), eccentricity और एक वैकल्पिक tolerance (डिफ़ॉल्ट 1e-6) लेती है, और अंशों में एक संख्या लौटाती है।
gauri_choghadiya	—	गौरी पंचांगम्, तमिल परंपरा में इस्तेमाल होने वाला दक्षिण भारतीय आठ भागों वाला विभाजन: दिन की आठ और रात की आठ अवधियाँ, हर एक दिनमान या रात का आठवाँ भाग; हर अवधि का नाम और उसका शुभ या अशुभ होना वार के हिसाब से बनी तालिका से तय होता है। {day_gowri, night_gowri} लौटाती है, दोनों आठ {name, status, start, end} की सूचियाँ, जहाँ status 'Good' या 'Bad' होता है।
godhuli_muhurta	—	गोधूलि, सूर्यास्त के आसपास का वह समय जब गायें धूल उड़ाती लौटती हैं: सूर्यास्त से दिन के एक मुहूर्त का चौथाई पहले से, सूर्यास्त के बाद रात के एक मुहूर्त का चौथाई बीतने तक। {start, end} लौटाती है।
gulika_kaalam	—	गुलिक काल, जिसे कुलिक भी कहते हैं: दिनमान का वह आठवाँ भाग जो शनि की छाया का माना जाता है। बाकी दोनों के उलट, इसे उन कामों के लिए अनुकूल माना जाता है जिन्हें टिकना या दोहराया जाना हो। {gulika_start, gulika_end} लौटाती है। यह special_longitudes की 'gulika' प्रविष्टि से अलग है, जो समय की अवधि नहीं, राशिचक्र में एक स्थिति है।
hora	—	चौबीस होराएँ: दिनमान के बारह बराबर भाग और रात के बारह, हर एक का स्वामी एक ग्रह, शास्त्रीय क्रम में, वार के अपने स्वामी से शुरू करके। {day_horas, night_horas} लौटाती है, दोनों बारह {planet, start, end} की सूचियाँ। विषुवों को छोड़कर दिन और रात की होराओं की लंबाई बराबर नहीं होती।
kali_samvat	—	कलियुग वर्ष, यानी shaka_samvat में 3179 जोड़कर; यह चैत्र शुक्ल प्रतिपदा पर बदलता है। एक पूर्णांक।
karana	—	माँगे गए क्षण पर चल रहा करण — आधी तिथि, यानी सूर्य से चंद्रमा की कोणीय दूरी के छह अंश। ग्यारह नामों में से एक लौटाती है: सात चर करण Bava, Balava, Kaulava, Taitula, Garaja, Vanija और Vishti, और चार स्थिर करण Kimstughna, Shakuni, Chatushpada और Naga। विष्टि वह करण है जिसे आमतौर पर भद्रा कहते हैं और जिससे बचा जाता है।
karana_segments	—	स्थानीय कैलेंडर दिन में पड़ने वाली हर करण अवधि, क्रम से {name, start_time, end_time} की सूची के रूप में। एक करण ग्यारह से तेरह घंटे चलता है, इसलिए हर दिन दो या तीन प्रविष्टियाँ आती हैं।
lagnas	—	पाँच विशेष लग्न, जो उदय राशि से तेज़ी से आगे बढ़ते हैं और सभी सूर्योदय से मापे जाते हैं। एक ऑब्जेक्ट लौटाती है जिसमें 'Bhava Lagna' (हर दो घंटे में एक राशि), 'Hora Lagna' (हर घंटे एक राशि; आय के लिए देखा जाता है), 'Ghati Lagna' (हर चौबीस मिनट में एक राशि; पद और अधिकार के लिए देखा जाता है), 'Indu Lagna' (लग्न और चंद्रमा से गिने गए नवमेशों से बना धन बिंदु) और 'Bhrigu Lagna' (चंद्रमा और राहु का मध्य बिंदु, जिसे आमतौर पर भृगु बिंदु कहते हैं) होते हैं, हर एक {degree, sign, minutes, seconds, nakshatra, pada}।
lunar_month	—	माँगी गई तारीख़ जिस अमांत चांद्र मास में पड़ती है — अमावस्या से अमावस्या तक — उसका नाम, जो उसे शुरू करने वाली अमावस्या पर चंद्रमा की राशि से तय होता है। बारह में से एक स्ट्रिंग, Vaisakha से Chaitra तक। अधिक मास को अलग से चिह्नित नहीं किया जाता।
lunar_month_poornima	—	वही महीना पूर्णिमांत गणना में, जो एक पूर्णिमा से अगली पूर्णिमा तक चलता है और जिसका नाम शुरुआती पूर्णिमा पर सूर्य की राशि से तय होता है। एक स्ट्रिंग। उत्तर भारतीय कैलेंडर इसी को मानते हैं, और कृष्ण पक्ष में यह उसी दिन के लिए lunar_month से अलग महीने का नाम देता है।
lunar_phase	—	सूर्य से चंद्रमा की कोणीय दूरी, और उससे तय होने वाला पक्ष। {paksha, moon_phase} लौटाती है, जहाँ moon_phase अंशों में 0 से 360 तक का कोण है, और paksha 180 से कम पर 'Shukla' और 180 या उससे ज़्यादा पर 'Krishna' होता है।
midday	—	स्थानीय दृश्य मध्याह्न — वह क्षण जब सूर्य दिए गए स्थान पर ऊर्ध्व याम्योत्तर पार करता है; यह घड़ी की दोपहर से कुछ मिनट आगे या पीछे होता है। timezone_as_float में भेजे गए ऑफ़सेट पर एक टाइमस्टैम्प।
midnight	—	सूर्य का अधो-याम्योत्तर पार करना, यानी वास्तविक स्थानीय मध्यरात्रि। माँगे गए ऑफ़सेट पर एक टाइमस्टैम्प। यह सूर्यास्त और सूर्योदय के बीच की रात का मध्य बिंदु नहीं है; nishita_muhurta उसी मध्य बिंदु पर आधारित है।
nakshatra_segments	—	स्थानीय कैलेंडर दिन में पड़ने वाला चंद्रमा का हर नक्षत्र, {name, start_time, end_time} की सूची के रूप में। सीमाएँ वे सटीक क्षण हैं जब चंद्रमा का भोगांश नक्षत्र की सीमा पार करता है, और ये द्विभाजन (bisection) से निकाले जाते हैं। नाम आधुनिक वर्तनी में हैं — Shatabhisha, Purva Bhadrapada — उन पुराने लिप्यंतरणों में नहीं जो इस API के कुछ दूसरे एंडपॉइंट इस्तेमाल करते हैं।
night_length	—	सूर्यास्त से अगले सूर्योदय तक की अवधि, सेकंड में; day_length की तरह यह भी संख्या नहीं, JSON स्ट्रिंग के रूप में मिलती है - "37464.0"। यह day_length की जोड़ीदार है, और choghadiya, hora और do_ghati के रात वाले हिस्सों का, और brahma_muhurta और nishita_muhurta का आधार है।
nishita_muhurta	—	निशीथ, सूर्यास्त और अगले सूर्योदय के बीच रात के मध्य बिंदु के दोनों ओर एक घटी, जहाँ घटी रात्रिमान का तीसवाँ भाग है। {start, end} लौटाती है। रात का मध्य और मध्यरात्रि एक ही क्षण नहीं हैं।
panchaka_rahita	—	दिन को अवधियों में बाँटा गया है, और हर अवधि पर उस पंचक का लेबल है जिसमें वह पड़ती है; यह शास्त्रीय (तिथि + नक्षत्र + वार + उदय राशि) mod 9 नियम से तय होता है। सूर्योदय से अगले सूर्योदय तक की {panchaka, start, end} की सूची लौटाती है, जहाँ पंचक-रहित अवधि के लिए panchaka null होता है, वरना 'Mrityu Panchaka', 'Agni Panchaka', 'Raja Panchaka', 'Chora Panchaka' या 'Roga Panchaka' में से एक। हर उदय राशि बदलने पर, और बीच में हर तिथि या नक्षत्र बदलने पर नई अवधि शुरू होती है, इसलिए आमतौर पर लगभग चौदह प्रविष्टियाँ आती हैं।
pratah_sandhya	—	प्रातः संध्या की अवधि: सूर्योदय से दो घटी पहले से एक घटी बाद तक, जहाँ घटी दिनमान का तीसवाँ भाग है। {start, end} लौटाती है।
rahu_kaalam	—	राहु काल: दिनमान का वह आठवाँ भाग जो कोई भी काम शुरू करने के लिए अनुपयुक्त माना जाता है; दिन में इसकी जगह वार से तय होती है। {rahu_start, rahu_end} लौटाती है, जिनके बीच day_length के आठवें भाग का अंतर होता है।
ritu	mode	ऋतु। mode तरीका चुनता है: 'drik' इसे सूर्य की सायन राशि से निकालता है, 'vedic' चांद्र मास से। {ritu, season, lord} लौटाती है, जैसे {'Vasanta', 'Spring', 'Venus'}। इंजन का डिफ़ॉल्ट 'drik' है, और इन दोनों के अलावा कोई भी वैल्यू त्रुटि देने के बजाय चुपचाप null लौटाती है।
samvatsara_name	samvata_type	साठ वर्ष के बार्हस्पत्य चक्र में वर्ष का नाम, Prabhava से Kshaya तक। samvata_type ज़रूरी है: 'vikram' उत्तर भारतीय नाम देता है (वर्ष की मेष संक्रांति के समय चल रहा, मध्यम बृहस्पति वाला संवत्सर), और 'shaka' चांद्र वर्ष से बँधा दक्षिण भारतीय नाम, इसलिए दोनों नाम अलग हो सकते हैं। एक स्ट्रिंग लौटाती है, और samvata_type न भेजने पर त्रुटि देती है।
sankranti_dates	—	माँगे गए क्षण के दोनों ओर सूर्य के राशि प्रवेश — यानी आप जिस सौर मास में हैं, उसकी सीमाएँ। {'Previous Sankranti', 'Next Sankranti'} को माँगे गए ऑफ़सेट पर टाइमस्टैम्प के रूप में लौटाती है।
sayahna_sandhya	—	सायाह्न संध्या की अवधि: सूर्यास्त से एक घटी पहले से दो घटी बाद तक, यहाँ भी दिनमान वाली घटियाँ। {start, end} लौटाती है।
shaka_samvat	—	शक संवत वर्ष। यह चैत्र शुक्ल प्रतिपदा पर बदलता है, इसलिए जनवरी से उस दिन तक यह ग्रेगोरियन वर्ष में से 79 घटाकर, और उसके बाद 78 घटाकर मिलता है। एक पूर्णांक।
shiva_vasa_segments	—	शिव का वास कहाँ है — रुद्राभिषेक से पहले की जाने वाली ऐसी ही जाँच, जो केवल तिथि से निकलती है। {state, start_time, end_time} की सूची लौटाती है, दिन के हर तिथि खंड के लिए एक; state सात में से एक होता है — गौरी के साथ, कैलाश में, वृषभ (नंदी) पर, भोजन में, सभा में, कार्य/क्रीड़ा में या श्मशान में — जिनमें पहले तीन अनुकूल हैं।
shunya_nakshatra	—	चंद्रमा इस समय उन दो या तीन नक्षत्रों में से किसी में है या नहीं, जो चल रहे अमांत चांद्र मास में शून्य माने जाते हैं और जिनमें नए काम शुरू करने से बचा जाता है। ऐसा हो, तो स्ट्रिंग 'shunya_nakshatra' लौटाती है, वरना null — यह सिर्फ़ एक फ़्लैग है, उत्तर में न कोई नाम होता है, न अवधि।
special_longitudes	—	समय से निकलने वाले छह उपग्रह। दिनमान या रात को आठ ग्रह-भागों में बाँटा जाता है, और किसी खास भाग के भीतर चुने गए बिंदु पर उदय राशि ली जाती है। ऐसा ऑब्जेक्ट लौटाती है जिसकी keys 'kaala', 'mrityu', 'artha_praharaka', 'yama_ghantaka', 'maandi' और 'gulika' हैं, हर एक {degree, sign, minutes, seconds, nakshatra, pada}। काल में सूर्य का भाग लिया जाता है, मृत्यु में मंगल का, अर्धप्रहारक और यमघंटक में बुध और बृहस्पति के भागों का मध्य, और गुलिक व मांदि में शनि का भाग — इसीलिए अनुरोध फ़ील्ड kala_mrityu_rise_at, gulika_rises_at और mandi_rises_at मायने रखते हैं: भाग का आरंभ, मध्य या अंत चुनना ही गुलिक को मांदि से अलग करता है।
sree_lagna	—	श्री लग्न, यानी समृद्धि का बिंदु: चंद्रमा अपने नक्षत्र का जितना भाग तय कर चुका है, लग्न को पूरे राशिचक्र के उतने ही भाग से आगे बढ़ाकर यह मिलता है। एक {degree, sign, minutes, seconds, nakshatra, pada} लौटाती है।
tamil_solar_month_date	—	तमिल सौर कैलेंडर की तारीख़। {'Tamil Solar Month', 'Tamil Solar Date'} लौटाती है — Chithirai से Panguni तक महीने का नाम, और दिन एक पूर्णांक के रूप में। यह इम्प्लीमेंटेशन दिन असली संक्रांति क्षणों से नहीं, 14 अप्रैल के तय नववर्ष से तीस-तीस दिन के खंडों में गिनता है, इसलिए नतीजा प्रकाशित तमिल पंचांगम् से एक-दो दिन अलग हो सकता है।
tarabala	—	ताराबल: सत्ताईस जन्म नक्षत्रों में से कौन-से गोचर चंद्रमा के नक्षत्र के हिसाब से अनुकूल स्थिति में हैं। {good_nakshatras, valid_until, good_nakshatras_tier2, tier2_valid_until} लौटाती है। पहली सूची में पंद्रह नाम होते हैं, और यह तब तक लागू रहती है जब तक चंद्रमा valid_until पर अपना वर्तमान नक्षत्र नहीं छोड़ देता; tier2 जोड़ी यही नियम अगले नक्षत्र पर लगाती है और अगले सूर्योदय तक लागू रहती है। अगर चंद्रमा दिन में नक्षत्र नहीं बदलता, तो दोनों tier2 फ़ील्ड null होते हैं।
tithi	—	माँगे गए क्षण की तिथि: {paksha, name, number, start_time, end_time, remaining_time}। number शुक्ल पक्ष के लिए 1-15, कृष्ण पक्ष के लिए 16-29 और अमावस्या के लिए 30 है, और remaining_time तिथि ख़त्म होने तक का समय {hours, minutes, seconds} में देता है। पूर्णिमा और अमावस्या पर paksha फ़ील्ड में पक्ष का नाम नहीं, 'Purnima' या 'Amavasya' आता है। दिन में पड़ने वाली हर तिथि के लिए tithi_segments इस्तेमाल करें।
tithi_segments	—	स्थानीय कैलेंडर दिन में पड़ने वाली हर तिथि, {paksha, name, number, start_time, end_time} की सूची के रूप में। number शुक्ल पक्ष में 1-15, कृष्ण पक्ष में 16-29, और अमावस्या के लिए 30 है। ध्यान दें कि पूर्णिमा और अमावस्या पर paksha फ़ील्ड में 'Shukla' या 'Krishna' नहीं, 'Purnima' या 'Amavasya' आता है। एक तिथि औसतन 23.6 घंटे की होती है, इसलिए ज़्यादातर दिनों में एक प्रविष्टि आती है और कुछ में दो।
trikalam	—	दिनमान के तीन बराबर भाग। {morning, afternoon, evening} लौटाती है, हर एक {start, end}। यह दिन का सीधा-सादा तीन भागों में बँटवारा है, वह राहु/यमगंड/गुलिक वाली तिकड़ी नहीं जिसे कुछ तमिल पंचांगम् में यह शब्द दर्शाता है।
true_anomaly	eccentric_anomaly, eccentricity	साथी कनवर्टर: eccentric_anomaly (अंशों में) और eccentricity लेती है, और ट्रू एनॉमली (true anomaly) अंशों में, एक संख्या के रूप में लौटाती है। ध्यान दें कि यह उत्केंद्र एनॉमली को उसी नाम वाले अनुरोध फ़ील्ड से पढ़ती है — उसी कॉल की eccentric_anomaly key के नतीजे से नहीं।
udaya_lagna_muhurta	—	दिन भर की लगातार बारह उदय राशि अवधियाँ, उस राशि से शुरू जो सूर्योदय से ठीक पहले से उदय हो रही है। क्रम से बारह {rashi, start, end} की सूची लौटाती है, जो लगभग एक नाक्षत्र दिन तक फैली होती है — यानी सूर्योदय से सूर्योदय तक के समय से लगभग चार मिनट कम। chandrabalam और panchaka_rahita, दोनों की गणना इसी सूची से होती है।
upagraha_longitudes	—	सूर्य के निरयन भोगांश से सीधे अंकगणित से निकलने वाले पाँच छाया बिंदु, हर एक पिछले बिंदु से: धूम सूर्य + 133°20' पर, फिर व्यतीपात, परिवेश, इंद्रचाप और उपकेतु। ऐसा ऑब्जेक्ट लौटाती है जिसकी keys 'Dhuma', 'Vyatipata', 'Parivesha', 'Indrachapa' और 'Upaketu' हैं, हर एक {degree, sign, minutes, seconds, nakshatra, pada}। dhuma_vyatipata_relation फ़ील्ड तय करता है कि व्यतीपात को धूम से जोड़ने के लिए दो शास्त्रीय सूत्रों में से कौन-सा लगेगा, और इससे उसके बाद के चारों बिंदु खिसक जाते हैं।
vaara	—	वार, जिसका नाम मध्यरात्रि के बजाय सूर्योदय से तय होता है, इसलिए मध्यरात्रि और सूर्योदय के बीच का क्षण अब भी पिछले वार का होता है। एक स्ट्रिंग: Ravivara, Somavara, Mangalavara, Budhavara, Guruvara, Shukravara या Shanivara।
vijaya_muhurta	—	विजय मुहूर्त: सूर्योदय और सूर्यास्त के बीच के पंद्रह बराबर मुहूर्तों में से 11वाँ, जो दोपहर बाद पड़ता है — विरोध के बावजूद जिस काम में सफल होना हो, उसके लिए यही अवधि है। {start, end} लौटाती है।
vikram_samvat	—	विक्रम संवत वर्ष। यह चैत्र शुक्ल प्रतिपदा पर बदलता है, इसलिए जनवरी से उस दिन तक यह ग्रेगोरियन वर्ष में 56 जोड़कर, और उसके बाद 57 जोड़कर मिलता है। एक पूर्णांक।
yamaganda_kaalam	—	यमगंड काल, दिनमान का वार से तय होने वाला दूसरा अशुभ आठवाँ भाग। {yamaganda_start, yamaganda_end} लौटाती है।
yoga_segments	—	स्थानीय कैलेंडर दिन में पड़ने वाली हर नित्य योग अवधि, क्रम से {name, start_time, end_time} की सूची के रूप में। एक योग औसतन लगभग 22.6 घंटे का होता है, इसलिए एक दिन में आमतौर पर दो योग पड़ते हैं। सीमाएँ वे सटीक क्षण हैं जब सूर्य और चंद्रमा के भोगांशों का योग सीमा पार करता है; इन्हें दिन तक पूर्णांकित नहीं किया जाता।
yogam	—	नित्य योग: सूर्य और चंद्रमा के निरयन भोगांश जोड़े जाते हैं, और योग को 13°20' के सत्ताईस बराबर चापों में बाँटा जाता है। माँगे गए क्षण के लिए एक नाम लौटाती है, Vishkambha से Vaidhriti तक। उस क्षण के आगे-पीछे की अवधियों के लिए yoga_segments इस्तेमाल करें।
yogas	—	इस समय लागू तिथि, नक्षत्र और वार के नाम वाले संयोग — वे शुभ और अशुभ 'योग' जो पंचांग में उस दिन के लिए दिए जाते हैं, जैसे सर्वार्थ सिद्धि, अमृत सिद्धि, द्विपुष्कर, त्रिपुष्कर, गुरु पुष्य, रवि पुष्य, पंचक, दग्ध, यमघंट, और लगभग बीस शास्त्रीय तालिकाओं से दर्जनों और। {yogas: [...]} लौटाती है — नामों की सूची, जो कोई योग लागू न हो तो खाली रहती है। यह yogam से अलग है, जो उस क्षण का एक नित्य योग है।

उदाहरण अनुरोध

curl -X POST https://api.occultapi.com/api/astro/panchanga/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2026-06-02T06:30:52.786Z","keys":["midday"],"latitude":26.849,"longitude":75.768,"timezone_as_float":5.5,"samvata_type":"shaka","mode":0,"mean_anomaly":0,"eccentricity":1,"tolerance":0.000001,"gulika_rises_at":"beginning","mandi_rises_at":"middle","kala_mrityu_rise_at":"middle","dhuma_vyatipata_relation":"360_minus_dhuma"}'

उत्तर

{
  "data": {
    "midday": "2026-06-02T12:24:53+05:30"
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं, हर नतीजा उसी नाम से जिससे आपने माँगा।

त्रुटियाँ

कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।