Numerology API

Bhagyank (Fate / Destiny Number) Computes the Bhagyank by summing all digits of the full birth date (day + month + year) and reducing to a single digit 1-9. The Bhagyank governs career, wealth, and life-path destiny. Returns full Vedic planetary detail with bilingual content. Required: dob Optional: name, system Returns: Bhagyank number, digit breakdown, ruling planet, gemstone, mantra, and bilingual interpretation.

Bridge Number The Bridge Number is the absolute difference between the Mulank and Bhagyank. It reveals the gap between who you are and your destined path, and what actions are needed to bridge that gap and achieve harmony between the two numbers. Required: dob Optional: name, system Returns: Bridge number, Mulank, Bhagyank, gap interpretation, and bilingual advice for bridging.

Business Compatibility Computes business partnership compatibility for numbers 1-9 based on the person's Mulank. Returns a ranked score for each partner number, identifies the best and avoid partner numbers, and provides Mulank-specific business-success advice. Required: dob Optional: name, system Returns: Compatibility scores (1-100) for all 9 numbers, best partners, numbers to avoid, and bilingual advice.

Career Guidance Career fields and work-style guidance from the Mulank (natural aptitude) and Bhagyank (long-term destiny direction), using the classical number career profiles. Careers appearing under BOTH numbers are the strongest recommendations. Required: dob Optional: name, system Returns: Career profiles for Mulank and Bhagyank, strongest overlapping careers, strengths/challenges, and bilingual advice.

Challenge Numbers Computes the four Challenge Numbers derived from the birth day, month, and year: First Challenge (youth), Second Challenge (midlife), Third / Main Challenge (lifetime), and Fourth Challenge (later life). Each reveals specific karmic obstacles to overcome. Required: dob Optional: name, system Returns: All four challenge numbers with themes, lessons, and bilingual advice for each life phase.

Child & Parenting Numerology Reveals a person's parenting style, child-related karma, strengths and challenges as a parent, favourable years for conception, and education guidance, derived from their Mulank and Bhagyank planetary numbers. Required: dob Optional: name, gender, system Returns: Per-number parenting profiles, favourable conception years, education guidance, and a bilingual interpretation.

Compound Number Interprets the double-digit birth day (before reduction to a Mulank). Numbers 10-31 each carry a distinct karmic flavour — fortune, caution, success, or spiritual power — overlaid on the single-digit root number. Based on Cheiro's system. Required: dob Optional: name, system Returns: Birth day, compound number meaning (en/hi), Mulank, and whether it's a fortunate compound.

Destiny / Expression Number Calculates the Destiny (Expression) number by summing the Chaldean or Pythagorean values of every letter in the full name, then reducing to a single digit (or master number). Reveals inherent talents, life mission, and natural abilities. Required: dob, name Optional: system (chaldean|pythagorean, default chaldean) Returns: Destiny number, letter breakdown, ruling planet, gemstone, and bilingual interpretation.

Finance & Wealth Numerology Profiles a person's financial nature, strengths, challenges, suitable investment types, lucky wealth years, and money remedies from their Mulank, Bhagyank, and Life Path numbers. Ideal for wealth-coaching and personal-finance apps. Required: dob Optional: name, gender, system Returns: Per-number finance profiles, best investment types, lucky years, and a bilingual interpretation.

First Letter / Cornerstone The Cornerstone is the first letter of the given name. In numerology, it is the most influential letter, shaping how a person approaches new beginnings, challenges, and opportunities. Returns the letter's numeric value, planet, and detailed meaning. Required: dob, name Optional: system Returns: First letter, its Chaldean value, ruling planet, element, traits, and bilingual interpretation.

Full Numerology Profile The most comprehensive numerology endpoint — computes every number in a single call: Mulank, Bhagyank, Life Path, Destiny, Soul Urge, Personality, Maturity, Personal Year, Name Number, Kua, Lo Shu Grid, 81-combination, Pinnacles, Challenges, Karmic Debt, plus full career, love, finance, marriage, health, child, lucky, compatibility, yantra, and remedies sections. Ideal for building complete numerology profile pages. Required: dob, gender ('male' or 'female') Optional: name (enables all name-derived numbers), system (chaldean|pythagorean) Returns: All numerology numbers, grid, combos, and all lifestyle/life-domain sections in one response.

Numerology Gun Milan (8-Koot Compatibility) Computes Vedic-style Ashtakoot (8-koot) marriage compatibility between two people using their numerology numbers — Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, and Nadi — out of 36 points, with Nadi-dosha detection and remedies. Required: person1_dob, person1_gender, person2_dob, person2_gender Optional: person1_name, person2_name, system Returns: All 8 koots (score/max/desc), total score, percentage, compatibility level, dosha flags, strengths, challenges, remedies, and a bilingual interpretation.

Health Numerology Maps each person's planetary numbers to vulnerable body areas, health strengths and challenges, favourable diet and colours, and recommended yoga/meditation, based on the body associations of the Mulank and Bhagyank ruling planets. Required: dob Optional: name, gender, system Returns: Per-number health profiles, combined vulnerable areas, diet & yoga advice, and a bilingual interpretation.

Karmic Debt Numbers Identifies whether the birth day, raw Bhagyank sum, or name raw sum contains any of the four karmic debt numbers (13, 14, 16, 19). Each karmic debt represents lessons from a past life that must be resolved — with specific challenges and remedies. Required: dob Optional: name, system Returns: List of karmic debt numbers found, their origin (DOB/name), past-life theme, lesson, and remedy.

Kua Number (Ba Gua / Feng Shui) Calculates the Kua (Gua) number from birth year and gender. The Kua number determines auspicious directions for sleeping, working, and facing during important activities, plus the Four Good and Four Bad directions for Feng Shui analysis. Required: dob, gender ('male' or 'female') Optional: name, system Returns: Kua number, group (East/West), four good directions, four bad directions, and bilingual interpretation.

Life Path Number Computes the Life Path — the most important number in Vedic and Western numerology — by reducing all digits of the date of birth. Master numbers (11, 22, 33) are preserved without reduction. Returns planetary ruler, gemstone, mantra, and a bilingual interpretation. Required: dob Optional: name, system Returns: Life Path number, digit breakdown, ruling planet, gemstone, mantra, and bilingual meaning.

Lo Shu Grid Generates the 3×3 Lo Shu magic square populated with DOB digits. Identifies which numbers (1-9) are present, absent, or repeated — each pattern revealing personality strengths, karmic gaps, and life lessons in the Vedic numerology tradition. Required: dob Optional: name, gender, system Returns: 3×3 grid matrix, digit counts, missing numbers, repeated numbers, plane analysis, and Kua number.

Love & Relationship Profile Relationship style, strengths, challenges, and number-compatibility from the Mulank (day-to-day temperament in love) and Bhagyank (long-term relationship destiny), using the classical number profiles. Required: dob Optional: name, system Returns: Love profile for Mulank and Bhagyank, combined compatible/incompatible numbers, and bilingual interpretation.

Lucky Numbers, Days & Colours Computes the personal lucky set — lucky numbers (from Life Path, Destiny, Soul Urge, and Personality), lucky days of the week, lucky colours, and the primary gemstone. Ideal for daily-horoscope and numerology-assistant features. Required: dob, name Optional: system (chaldean|pythagorean, default chaldean) Returns: Lucky numbers list, lucky days, lucky colours, primary gemstone, and bilingual recommendation.

Marriage Numerology Describes marriage nature, marital strengths and challenges, compatible and incompatible partner numbers, ideal marriage age range, auspicious years, and qualities to seek in a spouse, derived from Mulank, Bhagyank, and Soul Urge. Required: dob Optional: name (enables Soul Urge analysis), gender, system Returns: Per-number marriage profiles, compatible partner numbers, favourable years, and a bilingual interpretation.

Maturity Number The Maturity Number (Mulank + Bhagyank, reduced) is the final attainment number — the true purpose that crystallises after age 35-45 when a person reaches their prime. It reveals what life ultimately becomes and what fulfilment looks like. Required: dob Optional: name, system Returns: Maturity number, activation age range, ruling planet, gemstone, and bilingual interpretation.

Missing & Repeated Numbers Scans the Lo Shu grid (populated from DOB digits) to find absent numbers (karmic lessons not yet learned) and repeated numbers (amplified traits or overemphasis). Each missing number carries a specific life lesson; repetitions show core strengths. Required: dob Optional: name, system Returns: Missing numbers with lessons, repeated numbers with themes, and bilingual remedies for each gap.

Mulank (Radical / Root Number) Derives the Mulank (Vedic root number) from the birth day alone (e.g., born on the 28th → 2+8=10 → 1+0=1). The Mulank is the primary Vedic number and governs personality, health, and daily behaviour. Returns full planetary detail and bilingual remedies. Required: dob Optional: name, system Returns: Mulank number, ruling planet, gemstone, mantra, favourable days/colours, and bilingual interpretation.

Mulank & Bhagyank — Core Numbers The two foundational Vedic numerology numbers: Mulank (root number from the birth day — day-to-day nature) and Bhagyank (destiny number from the full date — life direction), each with its full planetary profile, and the relationship between the two. Required: dob Optional: name, system Returns: Both numbers with meanings, planets, gemstones, mantras, and their mutual relationship.

Name Analysis Breaks down every letter of the name into its Chaldean or Pythagorean numeric value, then computes the total, the reduced Destiny number, and the vowel/consonant sub-sums. Useful for name comparison, name-change analysis, and baby-name tools. Required: dob, name Optional: system (chaldean|pythagorean, default chaldean) Returns: Per-letter values, total, Destiny number, vowel sum, consonant sum, and letter count.

Name Correction & Spelling Suggestions Analyses whether the current name's Destiny number harmonises with the Mulank and Bhagyank under 5 explicit classical rules, then suggests up to 10 pronunciation-safe corrected spellings (vowel softening and/or middle initials) that pass every rule. Useful for name-correction consultations in Vedic astrology apps. Optionally accepts father_name/mother_name — when given, the response adds a family_sync block: a first-letter frequency analysis of each parent's name against the person's own first letter, Mulank, and Bhagyank, with bilingual descriptions. Corroborative context only; it never changes which spellings pass. Required: dob, name Optional: system (chaldean|pythagorean, default chaldean), father_name, mother_name Returns: Current harmony verdict, up to 10 rule-checked spelling suggestions with ratings and mechanisms, and family_sync (null unless a parent name was given).

Name Harmony Analysis Checks how well the name's numbers (Destiny, Soul Urge, Personality) harmonise with the birth numbers (Mulank, Bhagyank, Life Path) using the classical ideal-pair relationships. Returns a harmony score with per-pair detail — the analysis layer behind name-correction consultations. Required: dob, name Optional: system (chaldean|pythagorean, default chaldean) Returns: Harmony score (0-100), per-comparison detail, verdict, and bilingual interpretation.

Name Number Calculates the Name Number using the Chaldean or Pythagorean letter-value system, including the raw sum before reduction. Identifies master numbers and karmic debt numbers in the name. Returns gemstone, mantra, and full Vedic planetary detail. Required: dob, name Optional: system (chaldean|pythagorean, default chaldean) Returns: Name Number, raw sum, is_master_number flag, letter values, Vedic detail, and bilingual meaning.

Personal Month & Personal Day Numbers Returns the Personal Year, Personal Month, and Personal Day numbers calculated for today's date. These micro-cycle numbers guide day-to-day decisions, timing of important actions, and short-term energetic themes for the individual. Required: dob Optional: name, system Returns: Personal Year, Personal Month, and Personal Day numbers with themes, energy level, and advice.

Personal Year Number Calculates the Personal Year number for the current calendar year, which governs the themes, opportunities, and challenges for that 12-month cycle. Also returns the previous and next year's numbers for trend analysis. Required: dob Optional: name, system Returns: Current, previous, and next Personal Year numbers with bilingual themes and advice.

Personality Number Computes the Personality number from the consonants in the full name. It represents the outer mask — how others perceive you before they know you deeply — your first impression and social presentation style. Required: dob, name Optional: system (chaldean|pythagorean, default chaldean) Returns: Personality number, consonants used, ruling planet, gemstone, and bilingual interpretation.

Complete Numerology Remedies Returns all 12 categories of planetary remedies (gemstone, mantra, fasting, deity, colour, metal, yantra, charity, water offering, number writing, diet, and meditation) for both the Mulank and Bhagyank, in English and Hindi. Required: dob Optional: name, system Returns: Full 12-remedy sets for Mulank and Bhagyank plus combined bilingual advice.

Soul Urge / Heart's Desire Number Derives the Soul Urge number from the vowels in the full name. This number reveals the innermost desires, motivations, and what the person truly craves at a soul level — the hidden driver behind decisions and relationships. Required: dob, name Optional: system (chaldean|pythagorean, default chaldean) Returns: Soul Urge number, vowels used, ruling planet, gemstone, and bilingual interpretation.

Special Numerological Combinations Scans for rare power patterns — specific Mulank-Bhagyank combos (e.g., 1-1 Surya Yoga, 3-6 Guru-Shukra Yoga), repeated-digit patterns in the Lo Shu grid, and master-number presences — that bestow exceptional qualities or special karmic roles. Required: dob Optional: name, system Returns: Matched special combos with name, description, lucky factors, and whether Lo Shu power arrows are present.

Success Number The Success Number (Mulank + Bhagyank, reduced) synthesises the two primary Vedic numbers into a single power number that indicates the area of life where peak achievement is most likely. Returns full Vedic detail and bilingual guidance. Required: dob Optional: name, system Returns: Success number, ruling planet, gemstone, auspicious directions, and bilingual achievement themes.

Yantra Recommendations Returns the primary Yantra for the Mulank (root number) and secondary Yantra for the Bhagyank (fate number). Yantras are sacred geometric diagrams used for planetary remedy — includes the yantra name, deity, benefit, and activation instructions. Required: dob Optional: name, system Returns: Primary yantra (Mulank), secondary yantra (Bhagyank), deity, benefit, and bilingual activation method.