Mulank and bhagyank API reference
Updated
The core number endpoints of API for Astrology (apiforastrology.com) turn a name and a birth date into numbers. You get the mulank (birth day number), bhagyank (destiny number), name number and Lo Shu grid as JSON. Each number comes with a short reading. The group has 3 endpoints, including a printable report.
Call POST /v1/profile with a name and a birth date. For John Doe, born August 15, 1990, the mulank, bhagyank and name number are 6, 6 and 7. The quickstart walks through this call. The name number uses Chaldean letter values, with the Pythagorean one beside it, as Chaldean vs Pythagorean explains. POST /v1/report returns the whole reading as a printable book, like the sample report. GET /v1/guide/{number} reads one number with no birth date.
The core numbers for one person: the mulank (birth day number), the bhagyank (destiny number) and the name number, with the Lo Shu grid, lucky day, colors and dates, gemstone and mantra. Also one number on its own, and the whole reading as a printable report.
3 endpoints. Paths are relative to https://apiforastrology.com/api/numerology. Send your API key in the Authorization: Bearer header (see authentication). No key yet? Get a key. To send test requests from the browser, open the interactive reference.
Overview: Core numbers, Numerology report.
Which core numbers endpoint to call
| What you need | Endpoint | Cost |
|---|---|---|
| One person's core numbers and Lo Shu grid. Start here | POST /v1/profile | 3 reading credits |
| The whole reading as a printable book, in HTML or JSON | POST /v1/report | 25 reading credits |
| One number from 1 to 9 as a mulank, with no birth date | GET /v1/guide/{number} | 3 reading credits |
Core numbers and Lo Shu grid
POST /v1/profile
The core numbers for one person, each with a short reading. The mulank (birth day number) comes from the day of birth. The bhagyank (destiny number) comes from the full date. The name number is given in Chaldean (read) and Pythagorean (numbers only, read: false). The lucky day, colors and friendly numbers come from the mulank's planet. The Lo Shu grid comes with its missing and repeated numbers and its full or empty lines. loshu.basis says which digits were placed. not_included names what is not computed yet.
Uses 3 reading credits. On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. What reading credits buy.
Cost: 3 reading credits on a live key, 1 test call on a test key.
Required inputs
| Name | In | What it is |
|---|---|---|
| name | body | Full name as it is written and used, in English letters (A to Z). Spaces, dots, hyphens and apostrophes are allowed. Other scripts are refused, because the spelling changes the number. |
| birth_date | body | Date of birth, YYYY-MM-DD. The calendar date is used as it is, with no time of day. |
Optional inputs (2), with their defaults
| Name | In | What it does |
|---|---|---|
| lang | query | Language of the readings and names: en, hi. Codes stay in English. |
| detail | query | Length of the readings: standard (the default, short, for app cards) or expanded (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in localization.fell_back_to_standard. |
Main response fields
input(object): holds name, birth_date.mulank(object): holds number, planet, planet_name, about, reading, topics.bhagyank(object): holds number, total, master, planet, planet_name, about, reading, topics.name_number(object): holds default_system, chaldean, pythagorean.lucky(object): holds from, planet, planet_name, day, day_name, day_via, colors, numbers, dates, dates_about.remedies(object): holds from, planet, planet_name, direction, direction_name, direction_about, deity, deity_name, deity_about, fast_day, fast_day_name, fast_about.loshu(object): holds cells, placed, missing, repeated, planes, basis, about, summary, number_tip, birth_only.not_included(object): holds compound_meanings, western_numbers.not_claimed(string)localization(object): holds lang, detail, fell_back_to_en, fell_back_to_standard.
# 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": []
}
}Example from a real call for John Doe, born Aug 15, 1990. Long lists and texts are shortened.
Parameters, schemas and a test request in the interactive reference. Feature: Core numbers. Free tool: Numerology calculator, Lo Shu grid calculator.
Numerology report (HTML or JSON)
POST /v1/report
The whole reading as one printable book. It holds the numbers at a glance, the mulank, bhagyank and name number, and the Lo Shu grid (drawn). It also holds the lucky day and colors, the Western numbers, karmic lessons, challenges and life stages. It also holds the personal year, month and day, and any numbers sent in numbers. Every number and paragraph is what the other numerology routes return.
format=html (default) returns one self-contained page that fetches nothing and prints to A4. format=json returns the same book as data: chapters[].items[]. Each item is a section (blocks of title, paragraphs, note), a table (columns, rows) or loshu. A loshu item has cells and an svg that carries its look as attributes, so it draws anywhere.
Uses 25 reading credits. On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. What reading credits buy.
Cost: 25 reading credits on a live key, 1 test call on a test key.
Required inputs
| Name | In | What it is |
|---|---|---|
| name | body | Full name as it is written and used, in English letters (A to Z). Spaces, dots, hyphens and apostrophes are allowed. Other scripts are refused, because the spelling changes the number. |
| birth_date | body | Date of birth, YYYY-MM-DD. The calendar date is used as it is, with no time of day. |
Optional inputs (6), with their defaults
| Name | In | What it does |
|---|---|---|
| format | query | html (default) or json. |
| as_of | query | The date to read the personal year, month and day (and the current pinnacle and life cycle) for, YYYY-MM-DD. Defaults to today. Echoed back in as_of. |
| lang | query | Language of the readings and names: en, hi. Codes stay in English. |
| detail | query | Length of the readings. A report is read in full, so the default is expanded; send standard for a short version. |
| numbers | body | Up to 5 mobile, vehicle, house numbers or business names to read in the last chapter. Leave out for none. |
| brand | body | A name printed at the top of the cover, such as your app or company. Leave out for none. |
Main response fields
lang(string)prepared(string)as_of(string)tint(object): holds planet, paper, soft, highlight, strong, mute.cover(object): holds brand, kicker, title, born, glance, promise, wheel_title, wheel_caption, wheel_svg.labels(object): holds contents, chapter, closing, closing_text.chapters(array of objects): each item holds key, number, title, items.not_claimed(string)not_included(object): holds compound_meanings, western_numbers.footer(string)localization(object): holds lang, detail, fell_back_to_en, fell_back_to_standard.
# John Doe, born Aug 15, 1990
curl -X POST "https://apiforastrology.com/api/numerology/v1/report?format=json&as_of=2026-10-01&detail=standard" \
-H "Authorization: Bearer $ASTROLOGY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"John Doe","birth_date":"1990-08-15"}'{
"lang": "en",
"prepared": "2026-11-07",
"as_of": "2026-10-01",
"tint": {
"planet": "Venus",
"paper": "#fcf5f8",
"soft": "#f5e3eb",
"highlight": "#f0cfdd",
"strong": "#963a62",
"mute": "#75606a"
},
"cover": {
"brand": "",
"kicker": "Numerology report",
"title": "John Doe",
"born": "Born August 15, 1990",
"glance": "Mulank 6 · Bhagyank 6 · Name number 7",
"promise": "What your birth date and your name say about you, worked out step by step and written in plain words.",
"wheel_title": "Your numbers on the wheel of nine",
"wheel_caption": "The ring holds the numbers 1 to 9, each in the color of its planet. Your three numbers are marked. Your Lo Shu grid sits in the middle.",
"wheel_svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 600 670\" width=\"100%\" role=\"img\" aria-label=\"Your numbers on the wheel of nine\"><path d=\"M207.0,44.4…"
},
"labels": {
"contents": "Contents",
"chapter": "Chapter",
"closing": "A last word",
"closing_text": "Numbers show leanings, not a fixed future. Read this as a guide to know yourself better, and make your own choices."
},
"chapters": [
{
"key": "glance",
"number": 1,
"title": "Your numbers at a glance",
"items": [
{
"type": "table",
"title": null,
"columns": [
"What",
"Number"
],
"rows": [
[
"Mulank (birth day number)",
"6"
],
[
"Bhagyank (destiny number)",
"6"
]
]
}
]
},
{
"key": "mulank",
"number": 2,
"title": "Your mulank",
"items": [
{
"type": "section",
"blocks": [
{
"title": "Mulank (birth day number): 6",
"paragraphs": [
"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.",
"You care about home, family and things that look good. People feel welcome around you. Watch for spending too much on comfort."
]
},
{
"title": "Nature",
"paragraphs": [
"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…"
]
}
]
}
]
}
],
"not_claimed": "Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.",
"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."
},
"footer": "Prepared on November 7, 2026.",
"localization": {
"lang": "en",
"detail": "standard",
"fell_back_to_en": [],
"fell_back_to_standard": []
}
}Example from a real call for John Doe, born Aug 15, 1990. Long lists and texts are shortened.
Parameters, schemas and a test request in the interactive reference. Feature: Numerology report.
One number as a mulank
GET /v1/guide/{number}
Everything about one number from 1 to 9 as a mulank, with no birth date. It returns who has it (born_on, the days of a month) and its planet. It returns the mulank, bhagyank and name readings and the five topic sections. It also returns the lucky day, colors, numbers and dates, and the gemstone, mantra, direction, deity and fast day. For a page such as "mulank 5". The same entries the profile reads.
Uses 3 reading credits. On live keys a successful response uses them from your monthly reading credits, and no calls. Test keys answer for the sample people only, and it counts as 1 test call. What reading credits buy.
Cost: 3 reading credits on a live key, 1 test call on a test key.
Required inputs
| Name | In | What it is |
|---|---|---|
| number | path | The number, from 1 to 9. |
Optional inputs (2), with their defaults
| Name | In | What it does |
|---|---|---|
| lang | query | Language of the readings and names: en, hi. Codes stay in English. |
| detail | query | Length of the readings: standard (the default, short, for app cards) or expanded (about three times longer, for reading in full). A passage with no long form yet comes back at standard length and is listed in localization.fell_back_to_standard. |
Main response fields
number(number)planet(string)planet_name(string)born_on(array of numbers)mulank(object): holds number, planet, planet_name, about, reading, topics.bhagyank(object): holds number, planet, planet_name, about, reading, topics.name(object): holds about, reading.lucky(object): holds from, planet, planet_name, day, day_name, day_via, colors, numbers, dates, dates_about.remedies(object): holds from, planet, planet_name, direction, direction_name, direction_about, deity, deity_name, deity_about, fast_day, fast_day_name, fast_about.not_claimed(string)localization(object): holds lang, detail, fell_back_to_en, fell_back_to_standard.
# Mulank 6, John Doe's number
curl "https://apiforastrology.com/api/numerology/v1/guide/6" \
-H "Authorization: Bearer $ASTROLOGY_API_KEY"{
"number": 6,
"planet": "Venus",
"planet_name": "Venus",
"born_on": [
6,
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,
"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": {
"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 feels warm and pleasant. People may connect it with charm and good taste."
},
"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
}
},
"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": []
}
}Example from a real call for Mulank 6, John Doe's number. Long lists and texts are shortened.
Parameters, schemas and a test request in the interactive reference. Feature: Core numbers.
Where the rules come from
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. The Pythagorean letter values, 1 to 9 in alphabet order, match the table in L. Dow Balliett's The Philosophy of Numbers (1908).
Related pages
- Features: Core numbers, Numerology report.
- Used for: Numerology apps, Astrologer platforms, Dating apps, Matrimony and matchmaking sites.
- Free tools: Numerology calculator, Lo Shu grid calculator.
- Guides: Quickstart, Conventions, Errors, Changelog, Chaldean vs Pythagorean numerology.
Terms in this group
- Numerology
- Ank jyotish
- Number planets
- Mulank
- Bhagyank
- Friendly numbers
- Lucky day
- Lucky colors
- Favorable dates
- Lo Shu grid
- Missing numbers
- Repeated numbers
- Lo Shu planes
- Numerology gemstone
- Beej mantra
- Lucky direction
- Ruling deity
- Fast day
- Chaldean numerology
- Pythagorean numerology
- Name number
- Compound number
- Life path number
- Expression number