New Numerology API

Reports

Sample numerology report

This is a real report from POST /v1/report, for John Doe, born Aug 15, 1990. It is the full document your users would get, as one printable HTML page. It covers their core numbers, Lo Shu grid, lucky day and colors, Western numbers, life stages and personal year.
Open the full sample reportSee the endpoint

Updated

© API for Astrology (apiforastrology.com). "Sample report preview". All rights reserved. Not to be copied or reused.NUMEROLOGY REPORTJohn DoeAug 15, 1990What is in the report1Your numbers at a glance2Your mulank3Your bhagyank4Your name number5Your Lo Shu grid6Lucky day, colors and numbers7Gemstone and mantra8Your Western numbers9Lessons to work onand 3 more

What is in the report

The chapters of this sample, in order:

  1. Your numbers at a glance
  2. Your mulank
  3. Your bhagyank
  4. Your name number
  5. Your Lo Shu grid
  6. Lucky day, colors and numbers
  7. Gemstone and mantra
  8. Your Western numbers
  9. Lessons to work on
  10. Hidden passion and balance
  11. Challenges and life stages
  12. Your year, month and day

This sample is the standard length, about 2,700 words. The default length, expanded, is almost twice as long. Send numbers and the report adds a last chapter, “Your phone, vehicle and home numbers”. The report ends with a short note that numbers describe tendencies, not fixed events.

Make it yours

  • The cover carries no brand or link of ours. Send brand to print your own name on it.
  • It is one self-contained HTML file. It loads nothing from anywhere else, so it opens offline.
  • It prints to A4. To make a PDF, print the page from any browser, or run it through a headless browser on your server.
  • Every number and paragraph is what the other numerology routes return, so the report matches your app's screens.
  • Send format=json to get the same report as data, and lay it out your own way.

Two quotes from this report

Your mulank

Mulank (birth day number): 6

“You care about home, family and things that look good. People feel welcome around you. Watch for spending too much on comfort.”

Your Lo Shu grid

In short

“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, planning ahead, order and routine and learning from setbacks.”

Both are from the sample above: standard length, in English. The same report also comes in Hindi.

How to get it

Send a name and a birth date, as for any numerology call. This is the exact request behind the sample. The answer is the HTML page itself, so the code saves it as report.html. The full address is https://apiforastrology.com/api/numerology/v1/report.

POST /v1/report

# John Doe, born Aug 15, 1990
curl -X POST "https://apiforastrology.com/api/numerology/v1/report?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"}' \
  -o report.html

On a test key, the report comes back only for the sample people (John Doe and Jane Doe), free. On a live key, one full report uses 25 reading credits. The language and the length do not change the price. The Free plan includes 150 reading credits a month, enough for 6 full reports. See what credits buy.

Options

format
html (the default) for the printable page, or json for the same report as data.
lang
The language of the text: en (English) or hi (Hindi).
detail
expanded (the default) for the full text, or standard for a short version. This sample is standard.
as_of
A date (YYYY-MM-DD) to read the personal year, month and day for. Without it, the API uses today.
brand
In the body: your app or company name, up to 40 characters, printed at the top of the cover.
numbers
In the body: up to 5 mobile, vehicle or house numbers, or business names. Send each one as an object, such as {"kind": "mobile", "value": "98765 43210"}. The kind is mobile, vehicle, house or business. They are read in a last chapter, "Your phone, vehicle and home numbers".

The report is built from the same readings you can call one by one. For example, POST /v1/profile gives the core numbers. See the API reference.

Read next

Numerology API

Generate a report for your own users

Try POST /v1/report free with a test key for the sample people (John Doe and Jane Doe). For your own users, use a live key: the Free plan includes reading credits every month.

Get a free API keyOpen the API reference

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