curl -X POST https://api.occultapi.com/api/astro/numerology/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2026-09-01T06:00:00+05:30","name":"Ramesh Kumar","day":1,"month":9,"year":2026,"system":"chaldean","keys":["birthday_number","expression_number","life_path_number"]}'अंक ज्योतिष किसी नाम और जन्म की तारीख़ को एक-एक अंक में समेटकर उनका फलादेश करता है। यह एंडपॉइंट चार पद्धतियाँ देता है, जिन्हें system से चुना जाता है; हर पद्धति की अपनी अक्षर तालिका है और उपलब्ध keys का अपना समूह। 'chaldean' (डिफ़ॉल्ट) और 'pythagorean' पाश्चात्य जोड़ी हैं, और इनमें सोलह keys साझा हैं — लाइफ़ पाथ, एक्सप्रेशन, सोल अर्ज, पर्सनैलिटी आदि। इनमें अक्षरों के मान अलग हैं, और एक बात जानने योग्य है: पाइथागोरियन मास्टर नंबर 11 और 22 को बनाए रखता है, जबकि कैल्डियन हमेशा एक अंक तक ले आता है। इसलिए expression_number, soul_urge_number, maturity_number और life_path_number केवल पाइथागोरियन में 11 या 22 आ सकते हैं। पाइथागोरियन में तीन keys और हैं: pinnacle_cycles, balance_number और rational_thought। 'chinese' और 'vedic' अलग समूह हैं, और इनमें कोई key साझा नहीं, सिवाय personal_year_number के, जो चीनी पद्धति में भी चलती है। चुनी गई पद्धति से बाहर की key माँगने पर HTTP 400 मिलता है, और त्रुटि में उस key का नाम होता है। हर कॉल में date_time और name भेजें। year, month और day पर्सनल ईयर, मंथ और डे वाली keys की लक्ष्य तारीख़ हैं, और इनका डिफ़ॉल्ट आज की तारीख़ है; house_number और phone_number तभी ज़रूरी हैं जब वे keys माँगी जाएँ। हर key के परिणाम के साथ उत्तर में एक <key>_metadata ऑब्जेक्ट होता है, जिसमें उस key का इनपुट, सूत्र और अर्थ होता है, और साथ में या तो vedic_planet_associations, या चीनी पद्धति के लिए chinese_number_meanings।
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| 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 माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें। कौन-सी keys उपलब्ध हैं, यह `system` पर निर्भर है। कैल्डियन और पाइथागोरियन में सोलह keys साझा हैं; पाइथागोरियन में pinnacle_cycles, balance_number और rational_thought भी हैं; चीनी और वैदिक के अपने अलग समूह हैं और ये कोई दूसरी key स्वीकार नहीं करते। चुनी गई पद्धति से बाहर की key माँगने पर 400 मिलता है, और त्रुटि में उस key का नाम होता है। |
| name | string | ज़रूरी | |
| day | integer | वैकल्पिक | महीने का दिन, संख्या के रूप में (1-31)। |
| house_number | string | वैकल्पिक | मकान या फ़्लैट नंबर। केवल तभी ज़रूरी, जब 'keys' में 'house_number' शामिल हो। |
| month | integer | वैकल्पिक | जन्म का महीना, संख्या के रूप में (1-12)। जनवरी 1 है। |
| phone_number | string | वैकल्पिक | पूरा फ़ोन नंबर। केवल तभी ज़रूरी, जब 'keys' में 'phone_number' शामिल हो। |
| system | string | वैकल्पिक | कौन-सी अंक ज्योतिष पद्धति इस्तेमाल करनी है। ध्यान दें: कैल्डियन, पाइथागोरियन, चीनी और वैदिक पद्धतियाँ समर्थित हैं। chaldeanpythagoreanchinesevedic |
| year | integer | वैकल्पिक | जन्म का वर्ष, संख्या के रूप में, जैसे 1990। चार अंकों में। |
आपको जो गणनाएँ चाहिए, बस उन्हीं के नाम keys में लिखें। कोई एक भी अनजान नाम हुआ तो पूरा अनुरोध लौटा दिया जाता है। आप कितनी भी गणनाएँ माँगें, शुल्क 1 क्रेडिट ही लगता है — इसलिए सब एक साथ माँगें।
| Key | और कौन-से फ़ील्ड चाहिए | विवरण | |
|---|---|---|---|
| balance_number | — | नाम के हर शब्द का पहला अक्षर अंक में बदलकर जोड़ा जाता है, फिर एक अंक में लाया जाता है — यह वह सहारा है जिस पर व्यक्ति तनाव में लौटता है। 1-9 का एक पूर्णांक। केवल पाइथागोरियन पद्धति। | |
| bhagyank | — | वैदिक भाग्यांक: DDMMYYYY के रूप में लिखी जन्म की तारीख़ के आठों अंक जोड़कर एक अंक में लाए जाते हैं। 1-9 का एक पूर्णांक। केवल वैदिक पद्धति। | |
| birthday_number | — | psychic_number वाली वैल्यू ही लौटाती है — जन्म का दिन, एक अंक में लाया गया; 1-9 का एक पूर्णांक। ध्यान दें कि यह आम परिपाटी से अलग है, जिसमें बर्थडे नंबर दिन की पूरी संख्या (1-31) होता है। केवल तब उपलब्ध, जब `system` `chaldean`, `pythagorean` हो; बाकी पर 400 मिलता है। | |
| bridge_number | — | आप जो हैं और जो करते हैं, उनके बीच की दूरी: लाइफ़ पाथ नंबर और एक्सप्रेशन नंबर के एकल अंकों का निरपेक्ष अंतर। 0-8 का एक पूर्णांक; मान जितना छोटा, दोनों उतने करीब। केवल तब उपलब्ध, जब `system` `chaldean`, `pythagorean` हो; बाकी पर 400 मिलता है। | |
| challenge_number | — | जन्म महीने और जन्म दिन के एकल अंकों का निरपेक्ष अंतर। 0-8 का एक पूर्णांक। ध्यान दें कि यह एक ही संख्या लौटाती है, कुछ पद्धतियों में मिलने वाले चार चैलेंज नंबरों का समूह नहीं। केवल तब उपलब्ध, जब `system` `chaldean`, `pythagorean` हो; बाकी पर 400 मिलता है। | |
| chinese_name_number | — | नाम को पाश्चात्य अक्षर तालिका के बजाय पिनयिन-ध्वनि तालिका से अंक देकर एक अंक में लाया जाता है। चीनी अक्षर एक छोटी उपनाम तालिका में खोजे जाते हैं (जो अक्षर सूची में नहीं, उनके लिए एक फ़ॉलबैक मान है), और लैटिन अक्षरों के लिए पिनयिन मैप इस्तेमाल होता है। 1-9 का एक पूर्णांक। केवल चीनी पद्धति। | |
| compound_meaning | — | संयुक्त संख्या का शास्त्रीय नाम, 10 से 52 तक की तालिका से — 'The Wheel of Fortune', 'The Star of the Magi', 'The Crown of the Magi' आदि। एक स्ट्रिंग; अगर संयुक्त योग 10-52 से बाहर हो, जो लंबे नामों में अक्सर होता है, तो 'No specific meaning defined'। केवल तब उपलब्ध, जब `system` `chaldean`, `pythagorean` हो; बाकी पर 400 मिलता है। | |
| compound_number | — | चुनी गई पद्धति की तालिका से पूरे नाम के सभी अक्षरों का योग, एक अंक में लाए बिना — यही संख्या compound_meaning तालिका में खोजती है। एक पूर्णांक, जो नाम की लंबाई के हिसाब से आमतौर पर बीस से दो सौ के बीच होता है। केवल तब उपलब्ध, जब `system` `chaldean`, `pythagorean` हो; बाकी पर 400 मिलता है। | |
| expression_number | — | भाग्यांक (डेस्टिनी नंबर): पूरे नाम का हर अक्षर चुनी गई पद्धति की अक्षर तालिका से अंक में बदलकर जोड़ा जाता है, फिर एक अंक में लाया जाता है। एक पूर्णांक — कैल्डियन में हमेशा 1-9, और पाइथागोरियन में 1-9 या मास्टर नंबर 11 या 22, क्योंकि पाइथागोरियन इन्हें बनाए रखता है। केवल तब उपलब्ध, जब `system` `chaldean`, `pythagorean` हो; बाकी पर 400 मिलता है। | |
| five_element_balance | — | जन्म की तारीख़ के अंक, लाइफ़ पाथ नंबर और चीनी नाम संख्या पाँच तत्वों में कैसे बँटते हैं। {balance, interpretation} लौटाती है, जिसमें balance की keys Wood, Fire, Earth, Metal और Water हैं, और हर प्रविष्टि {count, percentage, meaning, associated_numbers} है। काष्ठ को 3 और 4 मिलते हैं, अग्नि को 9, पृथ्वी को 2, 5 और 8, धातु को 6 और 7, और जल को 1; शून्य कहीं नहीं गिने जाते। केवल चीनी पद्धति। | |
| growth_number | — | जन्म का दिन और जन्म का महीना, जोड़कर एक अंक में लाया गया। 1-9 का एक पूर्णांक। केवल तब उपलब्ध, जब `system` `chaldean`, `pythagorean` हो; बाकी पर 400 मिलता है। | |
| hidden_passion_number | — | पूरे नाम में सबसे ज़्यादा बार आने वाला अक्षर मान — वह प्रतिभा जो नाम में बार-बार लौटती है। एक पूर्णांक; अगर कई मान बराबर बार आएँ, तो सबसे छोटा लौटाया जाता है, और नाम में अंक देने लायक कोई अक्षर न हो, तो 0। केवल तब उपलब्ध, जब `system` `chaldean`, `pythagorean` हो; बाकी पर 400 मिलता है। | |
| house_number | house_number | house_number फ़ील्ड में भेजे गए मकान या फ़्लैट नंबर के अंक, जोड़कर एक अंक में लाए गए। 1-9 का एक पूर्णांक, या वैल्यू में कोई अंक न हो, तो 0। केवल चीनी पद्धति; यह key माँगने पर यह अनुरोध फ़ील्ड हमेशा ज़रूरी है। | |
| karmic_debt_numbers | — | वे अक्षर मान जो पूरे नाम में एक बार भी नहीं आते — जिन्हें ज़्यादातर पद्धतियाँ कार्मिक डेट नहीं, कार्मिक लेसन कहती हैं। गायब मानों की सूची लौटाती है: कैल्डियन में 1-8 में से (उसकी तालिका में 9 नहीं है) और पाइथागोरियन में 1-9 में से। यह शास्त्रीय 13/14/16/19 डेट नंबर नहीं लौटाती। केवल तब उपलब्ध, जब `system` `chaldean`, `pythagorean` हो; बाकी पर 400 मिलता है। | |
| life_path_number | — | जन्म का दिन, महीना और वर्ष, तीनों को पहले अलग-अलग एक अंक में लाकर जोड़ा जाता है, फिर योग को दोबारा एक अंक में लाया जाता है। एक पूर्णांक; पाइथागोरियन में 11 और 22 बने रहते हैं। personal_life_path_number और bhagyank से तुलना करें: वे तारीख़ के सारे अंक सीधे जोड़ती हैं, इसलिए उनका उत्तर अलग आ सकता है। केवल तब उपलब्ध, जब `system` `chaldean`, `pythagorean` हो; बाकी पर 400 मिलता है। | |
| loshu_grid_arrows | — | लो शू के चार तीर (arrows), यह देखकर परखे जाते हैं कि जन्म की तारीख़ में हर रेखा के तीनों अंक हैं या नहीं। ऐसा ऑब्जेक्ट लौटाती है जिसकी keys arrow_of_determination (1-5-9), arrow_of_emotional_balance (2-5-8), arrow_of_practicality (1-4-7) और arrow_of_intellect (3-6-9) हैं, हर एक {present, meaning}। केवल उपस्थिति बताई जाती है; खाली तीरों को अलग निष्कर्ष के रूप में नहीं गिना जाता। केवल चीनी पद्धति। | |
| lucky_numbers | — | जन्म वर्ष के चीनी राशि-पशु के भाग्यशाली अंक, और साथ में आमतौर पर शुभ माने जाने वाले 8, 6 और 9। अलग-अलग पूर्णांकों की क्रमबद्ध सूची लौटाती है, आमतौर पर चार से छह। केवल चीनी पद्धति। | |
| maturity_number | — | एक्सप्रेशन नंबर और लाइफ़ पाथ नंबर, जोड़कर एक अंक में लाया गया। एक पूर्णांक; पाइथागोरियन में 11 और 22 बने रहते हैं। केवल तब उपलब्ध, जब `system` `chaldean`, `pythagorean` हो; बाकी पर 400 मिलता है। | |
| moolank | — | वैदिक मूलांक: जन्म का दिन, एक अंक में लाया गया। 1-9 का एक पूर्णांक। केवल वैदिक पद्धति; इसका मान हमेशा psychic_number के बराबर होता है। | |
| namank | — | वैदिक नामांक: पूरे नाम को कैल्डियन अक्षर तालिका से अंक देकर एक अंक में लाया जाता है। 1-9 का एक पूर्णांक। केवल वैदिक पद्धति; यह हर हाल में कैल्डियन तालिका ही इस्तेमाल करती है। | |
| name_number | — | केवल पहला नाम — पहले स्पेस तक का हिस्सा — चुनी गई अक्षर तालिका से अंक में बदलकर जोड़ा जाता है और एक अंक में लाया जाता है। 1-9 का एक पूर्णांक; यहाँ पाइथागोरियन में भी मास्टर नंबर नहीं बचते। केवल तब उपलब्ध, जब `system` `chaldean`, `pythagorean` हो; बाकी पर 400 मिलता है। | |
| personal_life_path_number | — | DDMMYYYY के रूप में लिखी जन्म की तारीख़ के सभी अंक, जोड़कर एक अंक में लाए गए। 1-9 का एक पूर्णांक। केवल चीनी पद्धति; वैदिक key bhagyank बिल्कुल यही मान निकालती है। | |
| personal_year_number | year | किसी कैलेंडर वर्ष का विषय: जन्म का दिन, जन्म का महीना और लक्ष्य वर्ष, तीनों को पहले एक-एक अंक में लाया जाता है, फिर जोड़कर दोबारा एक अंक में। year लेती है, डिफ़ॉल्ट रूप से चालू वर्ष। 1-9 का एक पूर्णांक; यही इकलौती key है जो हर पद्धति में उपलब्ध है। | |
| personality_number | — | पूरे नाम के व्यंजन, जोड़कर एक अंक में लाए गए — बाहरी छवि, जबकि soul_urge_number भीतरी छवि बताती है। 1-9 का एक पूर्णांक, कभी मास्टर नंबर नहीं। केवल तब उपलब्ध, जब `system` `chaldean`, `pythagorean` हो; बाकी पर 400 मिलता है। | |
| phone_number | phone_number | phone_number फ़ील्ड में भेजे गए फ़ोन नंबर के अंक, जोड़कर एक अंक में लाए गए। 1-9 का एक पूर्णांक, या कोई अंक न हो, तो 0। केवल चीनी पद्धति; यह key माँगने पर यह फ़ील्ड हमेशा ज़रूरी है। | |
| pinnacle_cycles | — | चार पिनेकल, यानी पाइथागोरियन अंक ज्योतिष में जीवन के एक के बाद एक आने वाले चरण, जो जन्म महीने, दिन और वर्ष के एकल अंकों से बनते हैं। {first, second, third, fourth} लौटाती है, हर एक पूर्णांक, जिसमें 11 और 22 बने रहते हैं। केवल पाइथागोरियन पद्धति। | |
| psychic_number | — | मूलांक (रूट या साइकिक नंबर): जन्म की तारीख़ का दिन, एक अंक में लाया गया। 1-9 का एक पूर्णांक। केवल कैल्डियन और पाइथागोरियन पद्धतियाँ। | |
| rational_thought | — | पहले नाम के अक्षरों का योग और जन्म का दिन, जोड़कर एक अंक में लाया गया — इससे देखा जाता है कि व्यक्ति किसी समस्या पर कैसे सोचता है। 1-9 का एक पूर्णांक। केवल पाइथागोरियन पद्धति। | |
| soul_urge_number | — | हार्ट्स डिज़ायर नंबर: पूरे नाम के केवल स्वर, जोड़कर एक अंक में लाए गए। एक पूर्णांक; पाइथागोरियन में 11 और 22 बने रहते हैं। A, E, I, O और U गिने जाते हैं; Y नहीं। केवल तब उपलब्ध, जब `system` `chaldean`, `pythagorean` हो; बाकी पर 400 मिलता है। | |
| unlucky_numbers | — | उसी राशि-पशु के अशुभ अंक, और साथ में 4। अलग-अलग पूर्णांकों की क्रमबद्ध सूची लौटाती है। केवल चीनी पद्धति। | |
| vedic_grid | — | 3×3 जन्म ग्रिड, अंकों के स्वामी ग्रहों के साथ। {grid, grid_layout, details} लौटाती है: grid_layout तय व्यवस्था [[4,9,2],[3,5,7],[8,1,6]] है; grid उन्हीं स्थानों पर बताता है कि हर अंक जन्म की तारीख़ में कितनी बार आता है; और details की keys '1' से '9' हैं, हर एक {planet, meaning, count, active}। केवल वैदिक पद्धति। | |
| vedic_personal_day | year, month, day | पर्सनल डे: ((वैदिक पर्सनल मंथ + लक्ष्य दिन − 1) mod 9) + 1। year, month और day लेती है, हर एक का डिफ़ॉल्ट आज का। 1-9 का एक पूर्णांक। केवल वैदिक पद्धति। | |
| vedic_personal_month | year, month | पर्सनल मंथ: ((वैदिक पर्सनल ईयर + लक्ष्य महीना − 1) mod 9) + 1। year और month लेती है, हर एक का डिफ़ॉल्ट आज का। 1-9 का एक पूर्णांक। केवल वैदिक पद्धति। | |
| vedic_personal_year | year | वैदिक सूत्र ((जन्म दिन + जन्म महीना + लक्ष्य वर्ष − 1) mod 9) + 1 से निकला पर्सनल ईयर। ध्यान दें कि यह हर मान को पहले एक अंक में लाए बिना सीधे जोड़ती है, इसलिए उसी व्यक्ति और वर्ष के लिए इसका मान personal_year_number से अलग हो सकता है। year लेती है, डिफ़ॉल्ट रूप से चालू वर्ष। 1-9 का एक पूर्णांक। केवल वैदिक पद्धति। |