Full report
Numerology Report API: The Whole Reading as HTML or JSON
Updated
How the numerology report API works
- 1Send a name and a birth date, and up to 5 phone, vehicle or house numbers if you like.
- 2The API puts together what the profile, Western and number routes return, in a fixed chapter order.
- 3You get one HTML page that prints to A4 paper, or the same book as JSON.
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 John Doe's report holds, chapter by chapter
This is the real JSON answer for John Doe, born August 15, 1990, read on October 1, 2026. He sent no phone or vehicle numbers, so his book has 12 chapters and no numbers chapter.
| Chapter | Title in the report | What it holds |
|---|---|---|
| 1 | Your numbers at a glance | A table of his 11 main numbers |
| 2 | Your mulank | A reading of mulank 6 |
| 3 | Your bhagyank | A reading of bhagyank 6 |
| 4 | Your name number | A reading and two tables |
| 5 | Your Lo Shu grid | The drawn grid and a reading |
| 6 | Lucky day, colors and numbers | A table and a reading |
| 7 | Gemstone and mantra | A table and a reading |
| 8 | Your Western numbers | A reading |
| 9 | Lessons to work on | A reading |
| 10 | Hidden passion and balance | A reading |
| 11 | Challenges and life stages | Four readings and two tables |
| 12 | Your year, month and day | A reading |
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 numerology report 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/report
# 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": []
}
}What the numerology report API returns
- A cover with the name, birth date and three core numbers, marked on a wheel of the nine numbers. It carries no brand unless you send
brand. - Chapters on the mulank (birth day number), bhagyank (destiny number) and name number. Then the Lo Shu grid, drawn, with the lucky day, colors and remedies.
- The Western numbers, karmic lessons, hidden passion and balance, the challenges and the pinnacles (life stages).
- The personal year, month and day for today or for
as_of. A last chapter reads any numbers you sent. - With
format=json:chapters[].items[], where each item is asection, atableor aloshugrid with its own SVG. tint: the colors of the mulank's planet, which the cover uses.
The report uses expanded readings by default, since a book is read in full. Send detail=standard for a shorter one. Every number and paragraph matches what the other numerology routes return for the same person.
Numerology report 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.
- Numerology report (HTML or JSON)25 credits
The rules behind the numerology report API
The report assembles and does not compute: each number comes from the profile, Western and number routes. Its HTML is one page with no outside stylesheet, font or image. The Lo Shu drawing carries its look inside the SVG, so it draws the same anywhere. The cover takes the color of the mulank's planet.
The Chaldean letter values, with no letter worth 9, follow the table in Cheiro's Book of Numbers (1926). The Pythagorean letter values, 1 to 9 in alphabet order, match the table in L. Dow Balliett's The Philosophy of Numbers (1908). 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
From the blog
Numerology report API questions
All questionsIs the report a PDF?
No. It is one HTML page that fetches nothing from outside and prints to A4 paper. Send format=json to get the same chapters as data and lay them out yourself.
Can I put my brand on the cover?
Yes. Send a brand of up to 40 characters, and it is printed at the top of the cover. Leave it out and the cover carries no brand at all, ours included.
What is in the JSON version?
The same book as data. Each chapter holds items, and each item is a section of titled paragraphs, a table, or a loshu grid. The grid comes with an SVG that carries its look inside it, so it draws anywhere.
See the report referenceWhich languages and lengths are there?
English with lang=en or Hindi with lang=hi. A report uses expanded readings by default, since it is read in full. Send detail=standard for a shorter book. The price is the same for all of them.
Can the report include phone or vehicle numbers?
Yes. Send up to 5 items in the numbers field, each with a kind and a value. The kind is mobile, vehicle, house or business. They are read in the last chapter, just as POST /v1/number reads them.
Can the report disagree with the other routes?
No. It puts together what the profile, Western and number routes return, and computes nothing of its own. So each number and paragraph matches those routes for the same person, date, language and length.
What does a numerology report cost?
25 reading credits per live call, the same as the astrology full report, in every language and at either length. Test keys answer for John Doe and Jane Doe, the sample people in the docs.
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