New Numerology API

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
The sky over New York, Nov 16, 2026, 8:57 PM: Sun in Scorpio 0°, Vishakha nakshatra; Moon in Capricorn 25°, Dhanishtha nakshatra; Mars in Leo 2°, Magha nakshatra; Mercury in Libra 11°, Swati nakshatra; Jupiter in Leo 1°, Magha nakshatra; Venus in Virgo 28°, Chitra nakshatra; Saturn in Pisces 14°, Uttara Bhadrapada nakshatra, retrograde; Rahu in Aquarius 0°, Dhanishtha nakshatra; Ketu in Leo 0°, Magha nakshatra© API for Astrology (apiforastrology.com). "The sky right now wheel". All rights reserved. Not to be copied or reused.♈︎♉︎♊︎♋︎♌︎♍︎♎︎♏︎♐︎♑︎♒︎♓︎Ketu in Leo 0°, Magha nakshatraKeJupiter in Leo 1°, Magha nakshatraJuMars in Leo 2°, Magha nakshatraMaVenus in Virgo 28°, Chitra nakshatraVeMercury in Libra 11°, Swati nakshatraMeSun in Scorpio 0°, Vishakha nakshatraSuMoon in Capricorn 25°, Dhanishtha nakshatraMoRahu in Aquarius 0°, Dhanishtha nakshatraRaSaturn in Pisces 14°, Uttara Bhadrapada nakshatra, retrogradeSa
The sky right now over New York · Nov 16, 2026, 8:57 PMLive from GET /v1/sky

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.

Compare the two APIs
Live

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).

Dates: 1850 to 2149Zodiac: Sidereal (Vedic), Lahiri by default, or 7 other ayanamsasHouses: Whole sign (one sign per house)
Live

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.

Systems: Chaldean and PythagoreanInput: A name and a birth dateLanguages: English and Hindi

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.

John Doe, born Aug 15, 1990, 10:30 AM, New York

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"}'
Response (shortened)200 OK
{
  "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"
    }
  ]
}

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.

See all 14 features

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.

Every 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 API
  • Numerology 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
How we measured these

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 kundli
  • Kundli matching

    The 36-point guna milan score, the manglik check and a plain verdict for two people.

    Match two charts
  • Today'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 panchang
  • Manglik dosha calculator

    Whether Mars makes a chart manglik, counted three ways, with any exceptions.

    Check for manglik dosha
  • Sade 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 sati
  • Nakshatra finder

    Your birth star: the Moon's nakshatra, its quarter (pada), its ruler and your Moon sign.

    Find my nakshatra
  • Numerology calculator

    Your mulank, bhagyank and name number from a name and a birth date.

    Find my numbers
  • Life path number calculator

    Your life path number with master numbers kept, plus your expression, soul urge and personality numbers.

    Find my life path
  • Name numerology calculator

    A name's Chaldean and Pythagorean numbers, with other spellings compared against your birth date.

    Check my name
  • Lo 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

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.

  1. Supported

    2 languages

    Works today

    • EnglishDefault
    • हिन्दीHindilang=hi
  2. Coming soon

    5 languages

    Next on the list

    • मराठीMarathi
    • ગુજરાતીGujarati
    • 中文Chinese
    • தமிழ்Tamil
    • РусскийRussian
  3. Planned

    8 languages

    Not 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 language

Pricing

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.

See pricing

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.

Laptop showing charts on an office desk

Trust

Safe to build on

  • Birth details and names are not stored

    The API uses them to compute the answer, then drops them.

    Privacy Policy
  • Usage 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 quotas
  • Clear errors and limits

    Every error has a code and a plain message. Rate-limit headers show how many calls you have left this minute.

    Errors
  • Support 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

All posts

Astrology API and numerology API questions

All questions
What 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 features
Does 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 astrology
How 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 plans
How 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 quickstart
Are 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 rulebook
Can 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 guide
Does 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 returns
Does 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 policy
Which 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 reference
How 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 page
What 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 features
Does 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 systems
All numerology questions

API 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