For developers

Astrology API

The calculations behind this site's panchang, rashifal, kundli and matching pages, as plain JSON over HTTPS.

Get an API key

Sign in and create a key on your account's API page. Send it as a bearer token: /account/api

Authorization: Bearer ara_...

Access and limits

  • With a key: 600 requests per hour and 60 per minute, per key, on every endpoint.
  • Without a key: only the two GET endpoints (panchang and rashifal), 30 requests per hour per IP address, for trying the API out.
  • Kundli and matching always need a key. They are POST requests meant for your server; do not put a key in a public web page.
  • The GET endpoints send CORS headers, so a browser page may call them directly.
  • Every path ends with a slash, as written below. Without it you get a redirect first.
  • Limits are counted per server instance, so treat them as a floor, not a promise. Past the limit you get 429 with Retry-After.

Endpoints

GET /api/v1/panchang/

Key optional

The panchang for a date at a place: tithi, nakshatra, yoga and karana with end times, sunrise and sunset, Rahu Kaal and the other muhurta windows, choghadiya.

Parameters

dateYYYY-MM-DD, 1900 to 2100. Defaults to today at the place.
lat, lonLatitude and longitude in decimal degrees.
tzIANA time zone, e.g. Asia/Kolkata.

Example

curl "https://www.astrorahularya.com/api/v1/panchang/?date=2026-10-20&lat=28.6139&lon=77.209&tz=Asia/Kolkata" \
  -H "Authorization: Bearer ara_..."

GET /api/v1/rashifal/

Key optional

Today's published rashifal for one sign or all twelve. Daily is updated each morning (Indian time); weekly and monthly per period.

Parameters

signaries … pisces, or omit for all twelve.
perioddaily (default), weekly or monthly.
langen (default) or hi.

Example

curl "https://www.astrorahularya.com/api/v1/rashifal/?sign=leo&lang=hi"

POST /api/v1/kundli/

Key required

Planets with sign, degree, nakshatra, pada, house and retrograde; the lagna; and the Vimshottari mahadashas with the one running now.

Parameters

date, timeLocal birth date YYYY-MM-DD and time HH:MM (24-hour).
latitude, longitude, timezoneBirth place; timezone is IANA.
ayanamsaOptional: lahiri (default), raman, krishnamurti, true-chitra, thirukanitham.
houseSystemOptional: whole-sign (default), equal, placidus-kp.
nodeTypeOptional: true (default) or mean.

Example

curl -X POST "https://www.astrorahularya.com/api/v1/kundli/" \
  -H "Authorization: Bearer ara_..." -H "Content-Type: application/json" \
  -d '{"date":"1990-05-17","time":"08:30","latitude":19.076,"longitude":72.8777,"timezone":"Asia/Kolkata"}'

POST /api/v1/match/

Key required

Ashtakoota guna milan for two births: the eight kootas, the total out of 36, Nadi and Bhakoot dosha and their traditional exceptions.

Parameters

groom, brideEach { date, time, timezone }. Only the Moon is used, so the place's time zone is enough.

Example

curl -X POST "https://www.astrorahularya.com/api/v1/match/" \
  -H "Authorization: Bearer ara_..." -H "Content-Type: application/json" \
  -d '{"groom":{"date":"1988-01-02","time":"10:00","timezone":"Asia/Kolkata"},"bride":{"date":"1990-03-04","time":"22:15","timezone":"Asia/Kolkata"}}'

Errors

Errors are JSON: {"error": {"code": "invalid_request", "message": "..."}}. Codes: invalid_request (400), unauthorized (401), not_found (404), rate_limited (429), unavailable (503), calculation_failed (422).

How the numbers are worked out

Positions come from the panchang-ts ephemeris. The ascendant and the seven visible planets agree with the Swiss Ephemeris to about 0.01 degrees in our checks; Rahu and Ketu can differ from other software by up to half a degree because of the node model.

Defaults are the Lahiri ayanamsa, whole-sign houses and the true node, as on the kundli page. The kundli endpoint accepts the same settings as the page.

Matching is the traditional ashtakoota (guna milan) out of 36, on the Moon's nakshatra and sign, with the recognised Nadi and Bhakoot exceptions listed but never added to the score.

Fair use

The API is free while it stays affordable to run. Please credit astrorahularya.com where you show the results, and cache what you can: today's panchang for a place changes once a day.

Frequently asked questions

Is the API free?

Yes, within the limits above. If you need more, write to us with what you are building.

Can I call it from a web page?

The panchang and rashifal endpoints, yes, without a key. Keep keys on a server: anyone can read a key placed in a page.

What if my key leaks?

Revoke it on your account's API page and create a new one. A revoked key stops working within a minute.

Do you store the birth details I send?

No. Kundli and matching requests are calculated and answered; the details are not saved.

Building something for astrologers and want to talk it through? Book a consultation.

Book Consultation

Numerology report

Know the next 30 years of your life, from just your date of birth.

Your best years for money, marriage and career. The exact months to act. Start free in 10 seconds, unlock everything for just ₹299.

See what's inside the report
Date of birth
  • No sign-up
  • Free in 10 seconds
  • English & हिंदी