Vedic (Chaldean) & Western (Pythagorean): mulank, bhagyank, Lo Shu grid, 81 combinations, life path — Hindi + English in every response.
Get a free API key Try it in the playground
curl -X POST https://api.grahaapi.com/v1/numerology/bhagyank \
-H "Authorization: Bearer sk-test-your-key" \
-H "Content-Type: application/json" \
-d '{"dob":"1990-05-15","name":"Rahul Sharma","system":"chaldean"}'Test keys (sk-test-…) are free and unlimited — the response structure is guaranteed identical to production, so you can build your whole integration before paying anything.
| Endpoint | What it returns |
|---|---|
| POST /v1/numerology/bhagyank | **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. |
| POST /v1/numerology/bridge-number | **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. |
| POST /v1/numerology/business-compatibility | **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. |
| POST /v1/numerology/career | **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. |
| POST /v1/numerology/challenge-numbers | **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. |
| POST /v1/numerology/child | **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. |
| POST /v1/numerology/compound-number | **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. |
| POST /v1/numerology/destiny | **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. |
| POST /v1/numerology/finance | **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. |
| POST /v1/numerology/first-letter | **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. |
| POST /v1/numerology/full | **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. |
| POST /v1/numerology/gun-milan | **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. |
| POST /v1/numerology/health | **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. |
| POST /v1/numerology/karmic-debt | **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. |
| POST /v1/numerology/kua-number | **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. |
| POST /v1/numerology/life-path | **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. |
| POST /v1/numerology/loshu-grid | **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. |
| POST /v1/numerology/love | **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. |
| POST /v1/numerology/lucky-numbers | **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. |
| POST /v1/numerology/marriage | **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. |
| POST /v1/numerology/maturity-number | **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. |
| POST /v1/numerology/missing-numbers | **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. |
| POST /v1/numerology/mulank | **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. |
| POST /v1/numerology/mulank-bhagyank | **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. |
| POST /v1/numerology/name-analysis | **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. |
| POST /v1/numerology/name-correction | **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). |
| POST /v1/numerology/name-harmony | **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. |
| POST /v1/numerology/name-number | **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. |
| POST /v1/numerology/personal-month-day | **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. |
| POST /v1/numerology/personal-year | **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. |
| POST /v1/numerology/personality | **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. |
| POST /v1/numerology/remedies | **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. |
| POST /v1/numerology/soul-urge | **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. |
| POST /v1/numerology/special-combinations | **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. |
| POST /v1/numerology/success-number | **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. |
| POST /v1/numerology/yantra | **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. |
Vedic (Chaldean) & Western (Pythagorean): mulank, bhagyank, Lo Shu grid, 81 combinations, life path. Every response is JSON with both Hindi and English strings, computed astronomically on the Lahiri ayanamsa (the Indian government standard). This module has 36 endpoints.
Yes — sk-test- keys are free and unlimited, and return the exact production response structure (computed from a fixed sample chart). The Free plan then gives 1,000 real API calls per month with no credit card.
Simple INR pricing: Free (1,000 calls/mo), then paid plans from ₹499/mo. One call = one call on every endpoint — no credit system. Paid plans are throttled over quota, never blocked.
Full interactive reference for all 237 endpoints: GrahaAPI Docs · Plain-language explainers: Wiki