New Numerology API

Indian numerology

Mulank and Bhagyank API, with the Name Number and Lo Shu Grid

API for Astrology (apiforastrology.com) has a mulank and bhagyank API that also returns the Lo Shu grid.

Updated

© API for Astrology (apiforastrology.com). "Core numbers explained". All rights reserved. Not to be copied or reused.One date and one name, three numbersBirth dateName (Chaldean values)1155008811999900J1O7H5N5D4O7E5J1O7H5N5D4O7E5The day: 1 + 5156Mulank6VenusAll eight digits336Bhagyank633 is a master numberThe letters: 18 + 16347Name number7Ketu

How the mulank and bhagyank API works

  1. 1Send a name in English letters and a birth date, such as John Doe, born August 15, 1990.
  2. 2The API adds the digits: his mulank is 6, and his bhagyank is 6 from a total of 33.
  3. 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
      }
    ]
  }
}
John Doe's mulank with its planet and a short reading, his bhagyank, and his lucky day and friendly numbers. Real output for John Doe, born Aug 15, 1990.

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.

How John Doe's core numbers add up
NumberHow it adds upResult
Mulank (birth day number)Day 15: 1 + 5 = 66, 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 gridThe 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 dayThe weekday of Venus, the planet of mulank 6Friday

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.”

Work out any name and date with the free numerology calculator

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"}'
Response (lists shortened)200 OK
{
  "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 planes field lists the full ones and the empty ones. A short summary comes 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
Numerology API pricing

Try it free

No code needed

  • Numerology calculator

    Your mulank, bhagyank and name number from a name and a birth date.

    Find my numbers
  • Lo 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.

From the blog

Mulank and bhagyank API questions

All questions
What 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 is
Do 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 rules
What 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 read
Is 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 is
How 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 are
What 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 chosen
Which 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 API
What 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 credits

Numerology 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

POST /v1/profile200 OK
  • Mulank6Venus
  • Bhagyank6Destiny number
  • Name number7Ketu

Real API output. A free test key gets the same answer.

  1. 01

    Test key: 1,000 test calls a month to build with

  2. 02

    Free plan: 2,000 live calls a month, no card needed

  3. 03

    One key: the same key, plan and reading credits as the Astrology API