New Numerology API

Reports

Sample kundli (birth chart) report

This is a real report from POST /v1/report, for John Doe, born Aug 15, 1990, 10:30 AM, New York. It is the full document your users would get. It starts with a plain-language summary. Then come the chart, planet periods, planets and houses, as one printable HTML page.
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.KUNDLI REPORTJohn DoeAug 15, 1990, 10:30 AMNew YorkWhat is in the report1In plain words2Your signature3Your birth details4The chart5Your periods6The grahas7The houses8Where your chart disagrees with itself9What the chart formsand 2 more

What the report looks like

Two parts of the sample as a browser shows them. To read all of it, open the full sample report.

The top of the sample kundli report for John Doe: the title, a table of chart facts such as the Virgo ascendant and Taurus Moon sign, and the start of the In plain words chapter.
The top of the report: the chart facts, then a short summary in plain words.
The chart chapter of the sample kundli report, with plain-English readings of John Doe's Virgo ascendant and his birth star, Mrigashira.
A chapter: the rising sign and the birth star, read for this chart.

What is in the report

The chapters of this sample, in order:

  1. In plain words
  2. Your signature
  3. Your birth details
  4. The chart
  5. Your periods
  6. The grahas
  7. The houses
  8. Where your chart disagrees with itself
  9. What the chart forms
  10. What is moving now
  11. What is not here

Use it under your own brand

  • The document carries no brand or link of ours. Its heading is the title you send.
  • It is one self-contained HTML file: no scripts, web fonts or images from anywhere else, so it opens offline.
  • To make a PDF, print the page from any browser, or run it through a headless browser on your server.
  • Every paragraph is the same text the reading sections return, so the report never disagrees with your app's screens.
  • Some chapters have no text for this chart yet. They are listed under “What is not here”, not left out.

What the reading text sounds like

In plain words

In short

“You are practical first. You want to know how a thing really works, and you would rather do one job well than three halfway. People rely on you because you keep your word, so promise only what you can keep.”

In plain words

Work and career

“Work is one of the steadier parts of your life. What your career depends on leans more toward help than strain. So your effort tends to turn into position and income fairly easily. The risk is getting comfortable.”

Both are from the sample above: standard length, in English. Each paragraph is tied to a placement this chart really has. Your signature and Your birth details also list this chart’s values in a table. The rules behind the readings are in the rulebook.

Get this report with one API call

Send the same birth details as any chart 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/astrology/v1/report.

POST /v1/report

# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/report?as_of=2026-10-01&title=Kundli%20report%20for%20John%20Doe" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}' \
  -o report.html

On a test key, the report comes back only for the sample charts (John Doe and Jane Doe), free. On a live key, one full report uses 25 reading credits, or 40 with the topic chapters. A month’s reading credits cover about 6 full reports on the Free plan. On paid plans, that is about 40 on Starter, 200 on Growth and 880 on Scale. See pricing.

Options

title
Your heading for the document, such as your product's name. Without it, the heading is the rising sign.
lang
The language of the text: en or hi.
detail
standard, or expanded for text about 1.8 times longer.
as_of
A date (YYYY-MM-DD) for the transit and forecast chapters. Transits are where the planets move from that date, read against the birth chart. Without the date, those chapters are left out.
topics
true adds the 32 topic readings, such as career, love, wealth and education.

Some providers sell many report types. This API has one report with these options. It uses the same reading sections you can call one by one on the reading and report API.

Astrology API

Generate a report for your own users

Try POST /v1/report free with a test key on the sample charts (John Doe and Jane Doe). For your own users' charts, 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, New York

POST /v1/planets200 OK
  • RisingVirgoHast
  • SunCancerAshlesha
  • MoonTaurusMrigashira
  • MarsAriesKrittika

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

    Open rules: every rule is published, so you can check any answer