Numerology API
Numerology API for mulank, name numbers, life path and the Lo Shu grid
The numerology API from API for Astrology (apiforastrology.com) turns a name and a birth date into numbers. Each number shows how it was added up. It comes with a short reading in English or Hindi. The numbers include the mulank (birth day number, also called the driver number) and the bhagyank (destiny number, also called the conductor number). Indian numerology by default, with the Western numbers beside it.
- In one API
- 16 endpoints
- Default system
- Chaldean
- Readings in
- 2 languages
- With the Astrology API
- One key
{
"name": "John Doe",
"birth_date": "1990-08-15"
}- Mulank15 → 1 + 56
- Bhagyank33 → 3 + 36
- Name number34 → 3 + 47
Real output for John Doe, born Aug 15, 1990.
Updated
What is a numerology API?
A numerology API is a web service that turns a name and a birth date into numbers. The app sends both as JSON. The service maps letters to numbers and adds up the digits by fixed rules. It sends back each number, how it was added up and a short reading.
What can you build with the Numerology API?
The Numerology API is built for numerology apps, matrimony sites and dating apps. It also suits business naming tools, sellers of mobile numbers and names, and astrologer platforms. Each of these 6 use cases has its own page, with the endpoints that product needs.
How is the Numerology API different from the Astrology API?
The Numerology API needs only a name and a birth date, with no birth time or place. The Astrology API needs the birth date, the time and the place. Numerology answers use reading credits, while astrology calculations use calls. One API key and one plan cover both, with readings in English or Hindi.
Features
What the numerology API covers
16 endpoints: 15 in 8 features, plus a health check. Each one takes a name, a birth date or a number, and answers with JSON.
Indian numerology
Two people and time
Western numbers and reports
Your first call
John Doe, born on August 15, 1990. Send his name and birth date with your API key, and the core numbers come back as JSON. Set ASTROLOGY_API_KEY to your key: the same key works for both APIs. The answer here shows the core numbers only. The full answer also has the lucky day, the remedies and the Lo Shu grid. That grid is a 3 by 3 square filled from the birth date. The grid has eight lines, which many books call arrows. The answer lists the lines that are full and the ones that are empty.
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."
},
"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."
},
"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
}
}
}Numbers your users can read
- Every number comes with its planet and a short reading in plain words. The reading comes in English or Hindi.
- Each answer shows how the number was added up, so your app can show the working.
- Codes and keys stay in English in every language, so your code never changes with the language.
- Short text for app cards by default, or longer text for a full reading, at the same price.
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
}
]
}
}What it costs
Numerology uses the same plan and the same reading credits as the Astrology API. Each endpoint has one price in credits, in every language and at either length. Test keys are free and answer for the sample people.
Every numerology price- Two peoplePOST /v1/compatibility1 credit
- A day's numberGET /v1/day1 credit
- Personal year, month and dayPOST /v1/cycles2 credits
- Core numbers and Lo Shu gridPOST /v1/profile3 credits
- Numerology report (HTML or JSON)POST /v1/report25 credits
Use cases
Who builds with it
Languages
Readings in your users’ language
The Astrology API and the Numerology API answer in English and Hindi today. Names and reading text change with the language. Endpoint paths, codes and error messages stay in English.
Supported
2 languagesWorks today
- EnglishDefault
- हिन्दीHindilang=hi
Coming soon
2 languagesNext on the list
- 中文Chinese
- EspañolSpanish
Planned
9 languagesNot scheduled yet
- தமிழ்Tamil
- తెలుగుTelugu
- 日本語Japanese
- ಕನ್ನಡKannada
- FrançaisFrench
- മലയാളംMalayalam
- PortuguêsPortuguese
- РусскийRussian
- বাংলাBengali
Need a language sooner?Tell us which one. Requests help decide what comes next, and a language in progress gets a target quarter once its schedule is set.
Request a languageCommon questions
All questionsWhat does the Numerology API return?
Indian and Western numerology from a name and a date of birth. It returns the mulank (birth day number), the bhagyank (destiny number) and the name number. The Lo Shu grid comes with them, a 3 by 3 square filled from the birth date. Other routes check names, phone, vehicle and house numbers and business names. They also cover two-person compatibility, the Western numbers, the personal year, baby names and a printable report.
See all featuresDoes the API use Chaldean or Pythagorean numerology?
Both, kept apart. Names are read in the Chaldean system by default, which is what Indian numerology uses. The Pythagorean number comes back beside it, labelled, but it is not read. The Western numbers, such as the life path, use Pythagorean only.
Compare the two systemsDoes the Numerology API need a birth time or a birth place?
No. A person's numbers come from the calendar date of birth, with no time of day and no place. The mulank uses the date as it is, not a day that starts at sunrise.
How dates are readWhich languages do the readings come in?
English and Hindi. Send lang=hi for Hindi. Codes such as planet and outcome stay in English. The words in the reader's language sit beside them in *_name fields. The names you send must still be in English letters.
Read the conventionsDo I need a separate key for the Numerology API?
No. One key works for the Astrology API and the Numerology API. Send it the same way, to the numerology base URL https://apiforastrology.com/api/numerology, with paths such as POST /v1/profile.
How to send your keyCan I try the Numerology API for free?
Yes. Test keys are free and answer for the sample people in the docs. These are John Doe, born August 15, 1990, and Jane Doe, born March 22, 1992. They work for today or the dates in the docs, and each test call counts as 1 test call. For real people, the Free plan includes 150 reading credits a month.
Make your first callFrom the blog

· 10 min read
Numerology Chart: Every Number a Person Has, on One Screen
What goes on a numerology chart screen, and in what order.
Read
· 13 min read
Lucky Numbers, Colors and Days: Where They Come From
A lucky number calculator in Indian numerology takes every number, color and day from the birth day.
Read
· 17 min read
Numerology Chatbots: Give an AI Assistant Real Numbers
Build a numerology chatbot that never invents a number.
Read
Numerology API
Get your first numbers in five minutes
Create an account and a test key, then call any numerology endpoint with the sample people. The same key calls the Astrology API.
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