Use case
Numerology API for astrologer platforms
Updated
How it works
- 1Your platform sends the client's name and date of birth.
- 2The API returns the numbers, the readings and the checks, with the links behind each fit.
- 3After the session, one more call builds the client's report.
POST /v1/report?format=json&as_of=2026-10-01&detail=standard200 OK{
"cover": {
"kicker": "Numerology report",
"glance": "Mulank 6 · Bhagyank 6 · Name number 7"
},
"chapters": [
{
"number": 1,
"title": "Your numbers at a glance"
},
{
"number": 2,
"title": "Your mulank"
},
{
"number": 3,
"title": "Your bhagyank"
},
{
"number": 4,
"title": "Your name number"
},
{
"number": 5,
"title": "Your Lo Shu grid"
},
{
"number": 6,
"title": "Lucky day, colors and numbers"
}
]
}What you send, what you get, what it costs
| You send | The client's name in English letters and date of birth. Add up to 5 phone, vehicle or house numbers for the report. |
|---|---|
| You get | The core numbers, the Lo Shu grid and remedies, name corrections, number checks and a printable report with your platform's name. |
| It costs | 3 credits for the client's numbers, 1 credit for name corrections and 25 credits for the report. |
| Credits in a plan | The Free plan has 150 reading credits a month. Paid plans have more: Starter 1,000, Growth 5,000, Scale 22,000. Failed calls are free. |
How to build numerology into an astrologer platform
- 01
Open the client's numbers
POST /v1/profile3 creditsThe mulank (birth day number), bhagyank (destiny number) and name number with their readings, and the Lo Shu grid. Also remedies from the mulank's planet: a gemstone, a mantra, a direction, a deity and a fast day.
- 02
Suggest a name correction
POST /v1/name/suggest1 creditSpellings that keep the sound of the name and reach a number that suits the client, each with its changes.
- 03
Check a phone or vehicle number
POST /v1/number1 creditA mobile, vehicle or house number added up, its planet and its fit with the client. Letters are listed in ignored_letters and not counted.
- 04
Send a report after the session
POST /v1/report25 creditsThe whole reading as one printable book, in English or Hindi. Send brand for your platform's name on the cover, and numbers for up to 5 numbers in the last chapter.
Credits per flow: 30 credits for one of each call above, on a live key.
Step 1 in code: open the client's numbers
Send the details as JSON with your API key in the Authorization header. The other steps work the same way. Each one links to its page in the API reference.
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": []
}
}Tips for going live
- The report is long by default (detail=expanded). Send detail=standard for a shorter book at the same price.
- Compound numbers (10 to 52) come back in compound but are not read. Your astrologers can add their own reading.
- Keep the API key on your backend. The astrologer's screen gets data from your server, never the key itself.
- Ask clients how they spell their name in English letters. Each spelling gives a different number, and other scripts are refused.
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.
What it costs
A session with the profile, a name correction and a number check costs 5 credits, and the report adds 25.
Numerology uses reading credits from your plan, never calls, and the same key as the Astrology API. Test keys are free, with 1,000 test calls a month, and answer for the sample people. Failed requests are free.
Numerology API pricingFeatures used here
Read next
- Astrology API for astrologer platformsThe chart, the planetary periods and a branded report, with the same key.
- A sample numerology reportThe book a client gets after the session, made for John Doe.
- What a beej mantra isThe short seed mantra in the remedies, with its daily count.
Other numerology use cases:
Common questions
All questionsCan we put our own name on the report?
Yes. Send brand, up to 40 characters, and it prints at the top of the report's cover. With no brand, the cover has no brand line. Each report costs 25 credits.
About the numerology reportCan the report be in Hindi?
Yes. Send lang=hi for Hindi. The readings, chapter titles and names then come in that language. The price is the same in every language and at either length.
Read the conventionsCan we lay out the report in our own design?
Yes. Send format=json for the same book as data. Each chapter holds items: a section of text, a table or the Lo Shu grid. The grid comes with an SVG drawing that carries its own look, so it draws anywhere.
What the Lo Shu grid isHow does name correction work?
POST /v1/name/suggest tries small spelling changes that keep the name's sound, such as a to aa or v to w. It returns the spellings whose Chaldean number suits the client, each with its changes. If no small change works, the none field says so. To compare spellings the client already has, use POST /v1/name with up to 10 other spellings.
What name correction isDoes the Numerology API read compound numbers?
No. Compound numbers (10 to 52) come back in compound, but the API does not read them. Your astrologers can add their own reading.
What a compound number isDoes the API give remedies?
Yes. POST /v1/profile returns them under remedies, from the planet of the client's mulank. They are a gemstone with its metal and finger, a beej mantra, a direction, a deity and a fast day. A risky stone comes with its caution, never hidden. Ketu has no direction, and the answer says so.
How the gemstone is chosenCan the report include the client's phone and vehicle numbers?
Yes. Send up to 5 items in numbers, each with a kind (mobile, vehicle, house or business) and a value. They get a chapter of their own at the end of the report.
About number checksNumerology API
Start with a free test key
Create an account and a test key, then try each step above with the sample people. Need more than the largest plan? Write to us.
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