करण आधी तिथि होता है — सूर्य से चंद्रमा की दूरी के छह अंश, यानी लगभग ग्यारह से तेरह घंटे। करणों के ग्यारह नाम हैं: सात चर करण, जिनमें से हर एक चांद्र मास में आठ बार आता है, और चार स्थिर करण, जो एक-एक बार आते हैं। विष्टि, जिसे आमतौर पर भद्रा कहते हैं, वह करण है जिससे बचा जाता है।
यह एंडपॉइंट पूरे कैलेंडर वर्ष में किसी एक करण के हर आगमन को खोजता है, ताकि आप वर्ष को दिन-ब-दिन देखे बिना 'अगली विष्टि कब है' जैसी सूची बना सकें। karana_name ठीक उसी वर्तनी में भेजें जो फ़ील्ड की सूची में है (यह केस-संवेदी है), साथ में year और timezone_as_float; ऑफ़सेट से तय होता है कि स्थानीय वर्ष कब शुरू और कब ख़त्म होता है। अक्षांश या देशांतर की ज़रूरत नहीं, क्योंकि करण पूरी तरह चंद्रमा की गति पर आधारित है।
उत्तर {year, karana_name, rows} के रूप में मिलता है, जहाँ rows UTC में {start, end} टाइमस्टैम्प की कालक्रम वाली सूची है। स्थिर करण के लिए वर्ष में लगभग बारह पंक्तियाँ आती हैं और चर करण के लिए लगभग सौ। एक दिन के करणों के लिए इसके बजाय /api/astro/panchanga/ की karana_segments key इस्तेमाल करें।
स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए।
year
integer
ज़रूरी
जन्म का वर्ष, संख्या के रूप में, जैसे 1990। चार अंकों में।