Astrology API and numerology API, with answers you can explain
API for Astrology (apiforastrology.com) offers two REST APIs for developers: a Vedic astrology API and a numerology API. Send a birth date, time and place to get charts, planetary periods, matching and readings. Send a name and a birth date to get numerology. Every answer comes in plain words, in English or Hindi.
- In two APIs
- 81 endpoints
- For both APIs
- One key
- Answer languages
- English and Hindi
- Every month, no card
- 2,000 free calls
{
"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.
Our APIs
Use the astrology API, the numerology API, or both
One account and one key call both APIs. One plan and one pool of reading credits cover them.

Astrology API
Birth charts, planetary periods, the Hindu calendar, kundli matching and written readings. 65 endpoints, computed from NASA's JPL planet data (JPL DE440s).
Numerology API
Mulank (birth day number), bhagyank (destiny number), name numbers and the Lo Shu grid (a 3 by 3 number square). Also name and number checks, compatibility and a full report. 16 endpoints in 8 features.
Try it
Draw a birth chart from a real API answer
Pick a person or enter your own birth details. The chart and its notes come from a real API answer. It is the same JSON your app would get.
Asc is the rising sign. Each number is the sign in that house, 1 Aries to 12 Pisces. Your app can draw the chart in North, South or East Indian style from the same answer.
Your first call
One request, one clear answer
It is a REST API that answers in JSON. Send a birth date, time and place, or a name and a birth date, with your API key. Here is John Doe, born on August 15, 1990 at 10:30 AM in New York. The response box shows what the API sends back, shortened.
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/planets" \
-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"}'{
"ascendant": {
"name": "Ascendant",
"sign": "Virgo",
"degree_dms": "19 : 56 : 03",
"house": 1,
"nakshatra": "Hast"
},
"positions": [
{
"name": "Sun",
"sign": "Cancer",
"degree_dms": "28 : 46 : 31",
"house": 11,
"nakshatra": "Ashlesha"
},
{
"name": "Moon",
"sign": "Taurus",
"degree_dms": "24 : 34 : 30",
"house": 9,
"nakshatra": "Mrigashira"
}
]
}# 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"}'{
"mulank": {
"number": 6,
"planet": "Venus"
},
"bhagyank": {
"number": 6,
"total": 33,
"master": true
},
"name_number": {
"chaldean": {
"number": 7,
"total": 34
}
}
}What the API covers
The main parts of Vedic astrology, in one API
Each call takes a birth date, time and place. It returns the numbers and what they mean. These six are where most products start. The API also covers festivals, transits, daily horoscopes, planet strength and remedies. KP and Jaimini, two other Vedic systems, are in it too.
Kundli and birth charts
Planet positions, the rising sign and 16 divisional charts. Each divisional chart covers one part of life, such as the navamsa (D9) for marriage. It also has KP cusps and sub lords, used by the Krishnamurti method. Get the chart as data, or as an SVG or PNG picture in North, South or East Indian style.
Learn moreDashas (planetary periods)
Vimshottari, Yogini and Ashtottari periods, with the exact date each one starts and ends.
Learn morePanchang and muhurat
The Hindu calendar for any date and place. It gives the lunar day, nakshatra (the Moon's star group), rahu kaal and good times. Rahu kaal is a daily time to avoid new starts.
Learn moreKundli matching
The 36-point guna milan score, the 10 South Indian checks (poruthams), and a clear verdict: favorable, workable or difficult.
Learn moreYogas and doshas
Checks for manglik, kaal sarp and pitra dosha (chart flaws). A sade sati check gives the dates of Saturn's 7.5-year pass around the birth Moon. It also lists the yogas (planet combinations) found or not found, each with its rule.
Learn moreReadings and reports
Written readings on career, love, wealth and personality, and a printable report.
Learn more
More in the Astrology API:
And numerology
From a name and a birth date
Core numbers
A person's mulank (birth day number), bhagyank (destiny number) and name number. It also gives the Lo Shu grid, lucky day, colors and dates, gemstone and mantra.
Learn moreName checker
The number of a name and how well it fits the person's numbers. Check up to 10 spellings at once, or ask for spellings that sound the same and fit better.
Learn moreCompatibility
Two people's mulank and bhagyank read against each other, both ways, with a plain outcome and a short reading.
Learn morePersonal year and dates
A person's personal year, month and day, and the good dates in a month. It also gives a calendar year for one mulank and the number of any day.
Learn more
More in the Numerology API:
Plain-language answers
Real API answers, in words your users understand
The API returns the numbers and says what they mean, in plain words. The text comes from fixed rules, not an AI model. So the same birth details always get the same answer.
Manglik dosha check
“Manglik dosha is present, counted from your ascendant and your Moon. The main checks count from your ascendant (the sign rising at your birth) and from your Moon. It is common: about three in four charts have it from one of them.”
Real API output for John Doe
See how it worksKundli matching
workable
“This match can work. The main checks pass, with 22.5 out of 36 points. But a few things need a closer look before you decide.”
Real API output for Jane Doe and John Doe
See how it worksCareer reading
“Your chart backs your work more than most parts of your life. The effort you put in usually turns into results and a good name, often more easily than for others.”
Real API output for John Doe
See how it worksNumerology: mulank
Mulank 6
“You care about home, family and things that look good. People feel welcome around you. Watch for spending too much on comfort.”
Real API output for John Doe
See how it worksEvery astrology answer names the rule it used. Read them all in the public rulebook. Numerology answers follow the rules on the conventions page.
Measured, not guessed
Numbers we checked ourselves
Astrology API
161 of 161 festival dates matched a published Hindu calendar.
The place can change the day of a festival. The API works out each date for the city you send, as printed calendars do.
23 festivals, for New Delhi from 2023 to 2028 and Beijing in 2026.
The Hindu calendar APINumerology API
16.3% of birth dates have a master-number bhagyank.
Their digits add up through 11, 22 or 33 on the way to one digit. The API returns that digit with a master flag and the total, so your app can show both.
Every date from 1926 to 2025, 36,525 in all.
What master numbers are
Accuracy
Accuracy you can check
We check our results against NASA JPL Horizons, NASA's planet position service. On 25,571 positions from 1850 to 2149, the Sun and planets agree within 0.001″ and the Moon within 0.011″. We also cast 2,000 random charts from a birth clock time. Planets agree with Swiss Ephemeris within 0.06″, and the rising sign within 0.004″. An arc second (″) is 1/3,600 of a degree. Our tests fail if a result drifts past these figures.
Sources: NASA JPL planet data (DE440), Swiss Ephemeris, NASA JPL Horizons
0.001″
Planets, against NASA
0.011″
Moon, against NASA
0.004″
Rising sign, 2,000 charts
1850–2149
Years checked
Free tools
Try the API with no code
Ten free tools run on our APIs. Enter a birth date, time and place, or a name and a birth date. See the answer in your browser.
Free kundli
Your Vedic birth chart: the rising sign and all nine planets, with sign, house and nakshatra.
Make my kundliKundli matching
The 36-point guna milan score, the manglik check and a plain verdict for two people.
Match two chartsToday's panchang
Tithi (lunar day), nakshatra, sunrise and rahu kaal for your own city. The choghadiya shows the good and bad parts of the day.
See today's panchangManglik dosha calculator
Whether Mars makes a chart manglik, counted three ways, with any exceptions.
Check for manglik doshaSade sati calculator
Whether sade sati is running for you, which phase, and the dates. Sade sati is Saturn's 7.5-year pass around your Moon sign.
Check my sade satiNakshatra finder
Your birth star: the Moon's nakshatra, its quarter (pada), its ruler and your Moon sign.
Find my nakshatraNumerology calculator
Your mulank, bhagyank and name number from a name and a birth date.
Find my numbersLife path number calculator
Your life path number with master numbers kept, plus your expression, soul urge and personality numbers.
Find my life pathName numerology calculator
A name's Chaldean and Pythagorean numbers, with other spellings compared against your birth date.
Check my nameLo Shu grid calculator
The Lo Shu grid from a birth date, with missing and repeated numbers and full and empty lines.
Draw my Lo Shu grid
Use cases
Who builds with our APIs
Astrology API use cases
Numerology API use cases
Numerology apps
Core numbers at sign-up, a daily number, the personal year and a printable report. A small team can ship a numerology app with it.View use caseMatrimony and matchmaking sites
A numerology match for every pair of profiles, read both ways from two birth dates. Show it beside the 36-point kundli score.View use caseDating apps
Each user's numbers on their profile, and a numerology match for every pair from two birth dates. The match's number is explained too.View use caseBusiness naming tools
Check a business name against its owner. Get spellings that keep the sound and suit the owner better, and a launch date that fits.View use caseNumber and name sellers
Phone, vehicle and house numbers compared against a buyer's birth date, before the sale. Business names are checked against their owner too.View use caseAstrologer platforms
Name corrections, plus phone and vehicle number checks. A printable report for every client, in each supported language.View use case
Why pick this API
Why teams pick this API
Users ask why their chart says what it does. Public rules and fixed answers let you show them.
- 01
Every rule is public
The rulebook lists each rule the API uses, in plain words, so your team can check any answer. A practicing astrologer reviews the rules.
- 02
The same answer every time
Answers come from fixed rules, not an AI model. The same birth details always get the same result and the same words.
- 03
English and Hindi
Add lang=hi for Hindi. Names and reading text come from the same calculation as the English answer.
- 04
One key for every product
One account, one API key and one plan cover the Astrology API and the Numerology API, with one invoice.
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 and codes stay in English, and so do most error messages.
Supported
2 languagesWorks today
- EnglishDefault
- हिन्दीHindilang=hi
Coming soon
5 languagesNext on the list
- मराठीMarathi
- ગુજરાતીGujarati
- 中文Chinese
- தமிழ்Tamil
- РусскийRussian
Planned
8 languagesNot scheduled yet
- EspañolSpanish
- తెలుగుTelugu
- 日本語Japanese
- ಕನ್ನಡKannada
- FrançaisFrench
- മലയാളംMalayalam
- PortuguêsPortuguese
- বাংলাBengali
Need a language sooner?Tell us which one. Requests help decide what comes next.
Request a languagePricing
Start free with the astrology API
The astrology API and the numerology API share one Free plan, with no card. Each month it gives 2,000 calls and 150 reading credits. Written readings and numerology answers use the credits. Apps on the Free plan show a "Powered by" link on each page with API output. Paid plans start at $29 a month.
Free
For trying it out
$0
- Calls
- 2,000
- Credits
- 150
Starter
For a small app
$29/mo
$39/mo after Mar 31, 2027
- Calls
- 50,000
- Credits
- 1,000
Growth
RecommendedFor a growing app
$99/mo
$139/mo after Mar 31, 2027
- Calls
- 250,000
- Credits
- 5,000
Scale
For a large platform
$399/mo
$549/mo after Mar 31, 2027
- Calls
- 2,000,000
- Credits
- 22,000
Comparing astrology APIs? Our guide lists the checks to run before you choose one: coverage, accuracy, readings, pricing and privacy. A second guide does the same for numerology APIs.

Trust
Safe to build on
Birth details and names are not stored
The API uses them to compute the answer, then drops them.
Privacy PolicyUsage you can see
A dashboard shows your calls by day, endpoint and key. Emails warn you at 80% and 100% of your calls or credits.
Rate limits and quotasClear errors and limits
Every error has a code and a plain message. Rate-limit headers show how many calls you have left this minute.
ErrorsSupport from people
A person on our team reads every support request. We aim to reply within one business day.
Contact us
Blog
From the blog
Astrology API and numerology API questions
All questionsWhat can the astrology API calculate?
Birth charts (kundli), dashas (planetary periods), the panchang (Hindu calendar), muhurat (good times) and festival dates. Kundli matching, transits (the planets' current positions), daily horoscopes, yogas (planet combinations) and doshas (chart flaws). Planetary strength, the Jaimini system, remedies, and written readings and reports. Every answer comes back as JSON.
See all featuresDoes the astrology API do Western astrology or KP?
The astrology API is Vedic only, with no Western (tropical) positions. For KP (Krishnamurti Paddhati), POST /v1/kp returns house borders by the Placidus method. It also returns sub lords (the finer rulers KP reads). Significators come too: the planets that give each house its results. Every other endpoint keeps whole-sign houses. Any call can use the KP ayanamsa with "ayanamsa": "kp".
Vedic vs Western astrologyHow much does the astrology API cost?
The Free plan costs nothing and includes 2,000 calls and 150 reading credits a month. Starter is $29 a month, Growth $99 and Scale $399. These launch prices last until March 31, 2027. Then they are $39, $139 and $549. Paying for a year costs the same as 10 months. Test keys are free on every plan.
See all plansHow do I start using API for Astrology?
Sign up with your email, confirm it and create a test key in your account. Test keys are free on every plan. They return full readings for the sample charts, John Doe and Jane Doe. For real charts, the Free plan gives 2,000 calls and 150 reading credits a month, with no card needed.
Read the quickstartAre API for Astrology readings written by rules or by AI?
By rules, not AI. Each reading comes from a fixed library of text written ahead of time. Stated rules pick the text from the chart. Every rule is in the public rulebook with its own ID, such as DO-01 for manglik dosha. The same birth details always get the same words, in every language.
Browse the rulebookCan I use the astrology API with an AI assistant or chatbot?
Yes. Offer a few endpoints to the model as tools. The model calls the API for the chart and quotes the result. So it does not invent positions or rules. The reading text comes from fixed rules, not an AI model. So the same question gets the same answer in your tests. The guide lists a good first set of tools and the fields to quote.
Read the AI assistants guideDoes the astrology API return chart images?
Yes. POST /v1/chart/svg draws the birth chart, or any divisional chart, in North, South or East Indian style. It sends an SVG image, or a PNG picture with format=png. The other endpoints return the data, so you can also draw the chart yourself.
What the kundli API returnsDoes the astrology API store the birth details I send?
No. The API uses them only to compute the answer, and request bodies are not stored. Send birth details in the body of a POST request, because web addresses (URLs) can appear in server logs.
Read the privacy policyWhich programming languages work with the astrology API?
Any common one. Your code only has to make an HTTPS call and parse the JSON that comes back. The docs show every call in curl, JavaScript, Python and PHP. There is no SDK to install. To try every call, download our Postman collection or OpenAPI file from the API reference.
Open the API referenceHow do I get help, and is there a status page?
Write to us from the contact page. We aim to reply within one business day. The status page shows whether the API is working right now.
See the status pageWhat 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 systemsAPI for Astrology
Start building with either API
Create a free account and get a test key for both APIs. Or try a request in the API reference first.
Test key
1,000 test calls a month to build with
Free plan
2,000 live calls a month, no card needed
Open rules
every rule is published, so you can check any answer











