Indian numerology
Mulank and Bhagyank API, with the Name Number and Lo Shu Grid
Updated
How the mulank and bhagyank API works
- 1Send a name in English letters and a birth date, such as John Doe, born August 15, 1990.
- 2The API adds the digits: his mulank is 6, and his bhagyank is 6 from a total of 33.
- 3Each number comes back with its planet and a short or long reading, in English or Hindi.
POST /v1/profile200 OK{
"mulank": {
"number": 6,
"planet": "Venus",
"reading": "You care about home, family and things that look good. People feel welcome around you. Watch for spending too much on comfort."
},
"bhagyank": {
"number": 6,
"total": 33,
"master": true
},
"lucky": {
"day": "Friday",
"numbers": {
"friendly": [
4,
5,
6,
8
]
}
},
"loshu": {
"missing": [
{
"number": 2
},
{
"number": 3
},
{
"number": 4
}
]
}
}How John Doe's core numbers add up
This is the real answer for John Doe, born August 15, 1990. Each number adds up digits, or the letter values of the name, until one digit is left.
| Number | How it adds up | Result |
|---|---|---|
| Mulank (birth day number) | Day 15: 1 + 5 = 6 | 6, Venus |
| Bhagyank (destiny number) | 1 + 5 + 0 + 8 + 1 + 9 + 9 + 0 = 33, then 3 + 3 = 6. The total of 33 is a master number, so master is true. | 6, Venus |
| Name number (Chaldean letters) | John: 1 + 7 + 5 + 5 = 18. Doe: 4 + 7 + 5 = 16. 18 + 16 = 34, then 3 + 4 = 7. | 7, Ketu |
| Lo Shu grid | The digits 1, 5, 8, 1, 9 and 9, plus the bhagyank 6 and the mulank 6, since the 15th has two digits. Zeros are left out. | 2, 3, 4 and 7 are missing. The lines 8-1-6 and 9-5-1 are full. |
| Lucky day | The weekday of Venus, the planet of mulank 6 | Friday |
Every answer ends with the same caution in its not_claimed field: “Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.”
Call the mulank and bhagyank API from your code
Send the details as JSON with your API key in the Authorization header. Copy the code, set ASTROLOGY_API_KEY to your key, and run it. The same key works for the Astrology API.
POST /v1/profile
# John Doe, born Aug 15, 1990
curl -X POST "https://apiforastrology.com/api/numerology/v1/profile" \
-H "Authorization: Bearer $ASTROLOGY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"John Doe","birth_date":"1990-08-15"}'{
"input": {
"name": "John Doe",
"birth_date": "1990-08-15"
},
"mulank": {
"number": 6,
"planet": "Venus",
"planet_name": "Venus",
"about": "Your mulank (birth day number) comes from the day you were born. It shows how you act day to day and how people first see you.",
"reading": "You care about home, family and things that look good. People feel welcome around you. Watch for spending too much on comfort.",
"topics": [
{
"facet": "nature",
"title": "Nature",
"text": "Mulank 6 is ruled by Venus. You care about home, family and things that look good. People feel welcome around you, and you often keep peace in a group. You…"
},
{
"facet": "career",
"title": "Career",
"text": "You tend to work best in a pleasant place where you can make things better for people. You often have taste and a gift for making people feel at ease. Harsh or…"
}
]
},
"bhagyank": {
"number": 6,
"total": 33,
"master": true,
"planet": "Venus",
"planet_name": "Venus",
"about": "Your bhagyank (destiny number) comes from your full birth date. It shows the direction your life tends to take as you grow older.",
"reading": "Your life tends to center on family, love and responsibility. Work linked to beauty, art, care or comfort often suits this path.",
"topics": [
{
"facet": "nature",
"title": "Nature",
"text": "With Venus behind your bhagyank, care for family and a love of beauty tend to grow with age. You often become the one who brings people together and makes a…"
},
{
"facet": "career",
"title": "Career",
"text": "Your path tends to grow around beauty, care and comfort. You often do well in work that makes people's lives nicer or easier. Fields that tend to suit you…"
}
]
},
"name_number": {
"default_system": "chaldean",
"chaldean": {
"system": "chaldean",
"name": "John Doe",
"total": 34,
"compound": 34,
"number": 7,
"master": false,
"words": [
{
"word": "John",
"total": 18,
"number": 9
},
{
"word": "Doe",
"total": 16,
"number": 7
}
],
"system_name": "Chaldean",
"planet": "Ketu",
"planet_name": "Ketu",
"about": "Your name number comes from the letters of your name. It shows how your name shapes the way people take you.",
"reading": "Your name gives a quiet, thoughtful feel. People may see you as private or deep."
},
"pythagorean": {
"system": "pythagorean",
"name": "John Doe",
"total": 35,
"compound": 35,
"number": 8,
"master": false,
"words": [
{
"word": "John",
"total": 20,
"number": 2
},
{
"word": "Doe",
"total": 15,
"number": 6
}
],
"system_name": "Pythagorean",
"read": false
}
},
"lucky": {
"from": "mulank",
"planet": "Venus",
"planet_name": "Venus",
"day": "Friday",
"day_name": "Friday",
"day_via": null,
"colors": [
{
"color": "white",
"name": "white"
},
{
"color": "pastel pink",
"name": "pastel pink"
}
],
"numbers": {
"friendly": [
4,
5
],
"neutral": [
3,
7
],
"unfriendly": [
1,
2
]
},
"dates": [
4,
5
],
"dates_about": "Dates of the month that add up to a number friendly to your mulank. They tend to suit starting things."
},
"remedies": {
"from": "mulank",
"planet": "Venus",
"planet_name": "Venus",
"direction": "south-east",
"direction_name": "South-east",
"direction_about": "The direction linked to your ruling planet. Facing it for work or study is a common practice.",
"deity": "Lakshmi",
"deity_name": "Lakshmi",
"deity_about": "The deity often worshipped for your ruling planet. Families and regions may follow other customs.",
"fast_day": "Friday",
"fast_day_name": "Friday",
"fast_about": "The weekday of your ruling planet. People who fast for this planet usually keep this day.",
"gemstone": {
"stone": "diamond",
"metal": "silver or platinum",
"finger": "middle",
"caution": null,
"stone_name": "Diamond (heera)",
"metal_name": "silver or platinum",
"finger_name": "middle finger",
"about": "The stone linked to your ruling planet. Numbers alone cannot say whether you should wear it, so check your birth chart with an astrologer first."
},
"mantra": {
"key": "venus:beeja",
"text": "ॐ द्रां द्रीं द्रौं सः शुक्राय नमः",
"latin": "Om Draam Dreem Draum Sah Shukraya Namah",
"audio": "shukra-beej-mantra.mp3",
"daily": 108,
"japa": 16000,
"japa_sources": [],
"about": "The beej mantra (short seed mantra) of your ruling planet. One round is 108 times. The full count is for a complete practice.",
"japa_note": null
}
},
"loshu": {
"cells": [
[
{
"number": 4,
"count": 0
},
{
"number": 9,
"count": 2
}
],
[
{
"number": 3,
"count": 0
},
{
"number": 5,
"count": 1
}
]
],
"placed": [
{
"number": 1,
"from": "date",
"from_name": "birth date"
},
{
"number": 5,
"from": "date",
"from_name": "birth date"
}
],
"missing": [
{
"number": 2,
"reading": "2 is missing. You may not always notice how others feel. Slowing down to listen helps."
},
{
"number": 3,
"reading": "3 is missing. Planning ahead may not come easily. Writing your plans down can help."
}
],
"repeated": [
{
"number": 1,
"count": 2,
"reading": "1 appears more than once. Your self-belief is strong. Too much of it can come across as pride."
},
{
"number": 6,
"count": 2,
"reading": "6 appears more than once. You care a lot for home and family. Do not carry everyone's load alone."
}
],
"planes": [
{
"id": "practical",
"numbers": [
8,
1
],
"state": "full",
"name": "Practical line",
"reading": "The practical line is full. You tend to be good with hands-on work and money matters."
},
{
"id": "will",
"numbers": [
9,
5
],
"state": "full",
"name": "Willpower line",
"reading": "The willpower line is full. Once you decide, you tend to see it through."
}
],
"basis": "Non-zero digits of the birth date (DD MM YYYY), plus the bhagyank, plus the mulank when the day has two digits. Zero has no cell.",
"about": "The Lo Shu grid is a 3 by 3 square of the numbers 1 to 9. The digits of your birth date are placed in it. Numbers that are missing or repeated show what comes…",
"summary": {
"strong": [
{
"from": "number",
"number": 1,
"area": "self-belief"
},
{
"from": "number",
"number": 6,
"area": "caring for family"
}
],
"effort": [
{
"from": "number",
"number": 2,
"area": "noticing how others feel"
},
{
"from": "number",
"number": 3,
"area": "planning ahead"
}
],
"text": "Comes easily to you: self-belief, caring for family, drive, hands-on work and money and seeing things through. Needs more effort: noticing how others feel,…"
},
"number_tip": {
"digits": [
2,
3
],
"text": "Many people choose a mobile or vehicle number that has their missing numbers (2, 3, 4 and 7). This is a popular belief, not a promise."
},
"birth_only": "Your grid comes only from your birth date. Changing your name does not change it."
},
"not_included": {
"compound_meanings": "The compound number (10 to 52) is returned, but not read: its meanings wait for the astrologer.",
"western_numbers": "Life path, expression, soul urge, pinnacles, life cycles and the personal year come from the western route."
},
"not_claimed": "Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.",
"localization": {
"lang": "en",
"detail": "standard",
"fell_back_to_en": [],
"fell_back_to_standard": []
}
}What the mulank and bhagyank API returns
- The mulank and the bhagyank, each with its planet and a short reading. Each has five topic sections: nature, career, money, love and health.
- The name number in Chaldean, which is read, with the Pythagorean number beside it for comparison only (
read: false). Each word of the name is added up on its own too. - The Lo Shu grid with its missing numbers, repeated numbers, and full or empty lines, each with a reading. Many books call these lines planes or arrows. The
planesfield lists the full ones and the empty ones. A shortsummarycomes first, with the strong areas and the areas that take effort. - The lucky day, colors, friendly numbers and favorable dates of the month, all from the mulank's planet.
- The direction, deity, fast day, gemstone and beej mantra (a short seed mantra) of that planet. A stone that needs care comes with its caution.
- GET /v1/guide/{number}: the same readings for one number from 1 to 9, with no birth date needed. It also lists the days of a month that give it (
born_on).
Codes, such as the planet, stay in English in every language. Beside each code comes a word in the reader's language. The answer also lists what it does not cover yet, such as readings for compound numbers.
Mulank and bhagyank API endpoints
What it uses from your plan
Every numerology answer is a written reading, so it uses reading credits and no calls. The price is the same in every language and at either length. Failed requests are free.
- Core numbers and Lo Shu grid3 credits
- One number as a mulank3 credits
Try it free
No code needed
Numerology calculator
Your mulank, bhagyank and name number from a name and a birth date.
Find my numbersLo Shu grid calculator
The Lo Shu grid from a birth date, with missing and repeated numbers and full and empty lines.
Draw my Lo Shu grid
The rules behind the mulank and bhagyank API
Names are read in the Chaldean system by default, the one Indian numerology uses. The mulank uses the calendar date as it is, not a day that starts at sunrise. The bhagyank always ends on one digit. When its total passes through 11, 22 or 33, the answer sets master to true. Each number from 1 to 9 has a planet, in ank jyotish (Indian numerology) order. The Lo Shu grid holds the date's digits, the bhagyank, and the mulank when the day has two digits.
The Chaldean letter values, with no letter worth 9, follow the table in Cheiro's Book of Numbers (1926). The mulank (birth day number) is the day of birth, added down to one digit. The 1st, 10th, 19th and 28th all give 1, as in Cheiro's Book of Numbers (1926). The Lo Shu square holds the numbers 1 to 9 once each. Every line adds to 15, as shown by Wolfram MathWorld.
Who uses it
- Numerology appsCore numbers at sign-up, a daily number, the personal year and a printable report. A small team can ship a numerology app with it.
- Astrologer platformsName corrections, phone and vehicle number checks, and a printable report for every client, in each supported language.
- Dating appsEach user's numbers on their profile, and a numerology match for every pair from two birth dates. The match's number is explained too.
- Matrimony and matchmaking sitesA numerology match for every pair of profiles, read both ways from two birth dates. Show it beside the 36-point kundli score.
From the blog

· 17 min read
Numerology Chatbots: Give an AI Assistant Real Numbers
Build a numerology chatbot that never invents a number.
Read
· 12 min read
Date of Birth Numerology: Every Number From the Date Alone
Date of birth numerology for app builders.
Read
· 12 min read
Missing Numbers and Lines in the Lo Shu Grid
What a Lo Shu grid's missing numbers and its full or empty lines mean.
Read
Mulank and bhagyank API questions
All questionsWhat is the difference between mulank and bhagyank?
The mulank (birth day number) comes from the day of birth only. The bhagyank (destiny number) comes from the whole date. John Doe was born on the 15th, so his mulank is 1 + 5 = 6. His whole date adds up to 33, then 6, so his bhagyank is 6 too. For most people the two numbers differ.
What the bhagyank isDo the core numbers need a birth time or a birth place?
No. The core numbers need only a name and a birth date in YYYY-MM-DD form, such as 1990-08-15. The mulank uses the calendar date as it is. So a birth before sunrise keeps its date and its mulank.
Read the date rulesWhat if my user types their name in Hindi?
The call is refused with a 422 error, and error.field names the field at fault. The API does not change Hindi letters into English ones, because each spelling gives a different number. Ask your users how they write their name in English letters.
How names are readIs the mulank added to the Lo Shu grid?
Only when the day of birth has two digits, such as the 15th. A day from 1 to 9 is already in the grid, so adding it again would count it twice. The bhagyank is always added. Zeros are dropped, since zero has no cell.
What the Lo Shu grid isHow are master numbers handled in the bhagyank?
The bhagyank (destiny number) always ends on one digit, as Indian numerology does. The full sum comes back in the total field. The master flag is true when the sum passes through 11, 22 or 33. John Doe's date adds up to 33, so his bhagyank is 6 with master set to true.
What master numbers areWhat is the lucky day for mulank 4 or 7?
Rahu (4) and Ketu (7) have no weekday of their own, so they take Saturn's and Mars's. That makes Saturday the lucky day for 4 and Tuesday for 7. The day_via field names the planet the day came from.
How the lucky day is chosenWhich languages and lengths can I get?
English with lang=en or Hindi with lang=hi. Send detail=standard for short text that fits an app card, or detail=expanded for text about three times longer. The five topic sections have one length. The price is the same for every language and length.
Can a person's core numbers come as one printable report?
Yes. POST /v1/report puts the mulank, bhagyank, name number, Lo Shu grid, lucky day and gemstone into one book. The Western numbers and the personal year come in the same book. It comes as one printable HTML page, or as JSON chapters for your own layout. Each number matches what POST /v1/profile returns for the same person.
About the numerology report APIWhat do the core number routes cost, and can I test them?
POST /v1/profile reads one person and costs 3 reading credits on a live key. GET /v1/guide/{number} reads one number from 1 to 9 with no person, for 3 credits. Test keys answer for John Doe and Jane Doe, and the guide takes their mulanks, 6 and 4. Each test call counts as 1 test call.
See numerology creditsNumerology API
Call it with a free test key
Create an account and a test key, then call any endpoint on this page with the sample people. Or try a request in the API reference first.
Your first answer
John Doe, born Aug 15, 1990
- Mulank6Venus
- Bhagyank6Destiny number
- Name number7Ketu
Real API output. A free test key gets the same answer.
01
Test key: 1,000 test calls a month to build with
02
Free plan: 2,000 live calls a month, no card needed
03
One key: the same key, plan and reading credits as the Astrology API