Features
Vedic astrology API features
Updated
Every feature is called the same way
- 1Send a birth date, local time and place as JSON, with your API key in the Authorization header. Calendar calls need only a date and a place.
- 2The API places the planets for that moment from NASA JPL data, then applies the published rules for the feature you called.
- 3It answers in JSON your app can show as it is: charts, life periods, daily times, match scores and readings in plain English.
POST /v1/planets
# 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"}'Birth charts
The chart itself: where each planet is, how strong it is, and the Jaimini view.
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. Get the chart as data, or as an SVG or PNG picture in North, South or East Indian style.
- POST /v1/planetsPlanet positions and the ascendant
- POST /v1/ascendantThe ascendant only
- POST /v1/chart/{division}Any of the 16 divisional charts (D1 to D60)
- POST /v1/aspectsPlanet aspects (graha drishti)
- POST /v1/chart/chalitBhava chalit: houses by the Sripati method
- POST /v1/kpKrishnamurti Paddhati: cusps, sub lords, significators
- POST /v1/special-lagnasSpecial lagnas, the yogi point, Jaimini lords and dagdha signs
- POST /v1/upagrahasUpagrahas: Gulika, Mandi, the kaala velas and the Dhoomadi points
- POST /v1/chart/svgThe birth chart or any divisional chart as an SVG or PNG image
- POST /v1/chart/sudarshanaSudarshana chakra: the chart from the ascendant, Moon and Sun
Planetary strength
Shadbala, the six-part strength score, and ashtakavarga points (a score for each sign), with each part of the score.
- POST /v1/shadbalaPlanet and house strength (shadbala and bhava bala)
- POST /v1/ashtakavargaAshtakavarga: strength points for each sign
- POST /v1/strength/vimshopakaDivisional-chart strength, ishta and kashta phala, and planet friendships
- POST /v1/avasthasPlanetary states (graha avasthas)
Jaimini astrology
The Jaimini system, another Vedic method. It gives planet roles (chara karakas), periods by sign (chara dasha), sign aspects and argala (pulls on a sign).
- POST /v1/jaiminiJaimini: sign aspects, argala, chara dasha and karakas
- POST /v1/dasha/narayanaNarayana dasha: the Jaimini sign periods
Try it free
See an answer with no code
Free tools on this site run on the same API. Enter a birth date, time and place and see the result in your browser.
Timing
When things happen: planetary periods, transits and the Hindu calendar.
Dashas (planetary periods)
Vimshottari, Yogini and Ashtottari periods, with the exact date each one starts and ends.
- POST /v1/dasha/vimshottariVimshottari dasha periods with dates
- POST /v1/dasha/yoginiYogini dasha periods (a 36-year cycle)
- POST /v1/dasha/ashtottariAshtottari dasha periods (a 108-year cycle)
Transits and forecasts
Where the planets are now against a birth chart, dated forecasts, sign change and retrograde dates, and the yearly chart (varshaphal).
- POST /v1/transitsCurrent transits read against a chart
- POST /v1/transits/forecastUpcoming transit periods for a chart
- POST /v1/transits/ingresses/{graha}When a planet enters and leaves each sign
- POST /v1/transits/over/{graha}When a transiting planet passes over a birth-chart point
- POST /v1/forecast/annualYearly forecast: a year of sky events read against a chart
- GET /v1/skyPlanet positions at a moment, no chart
- GET /v1/sky/eventsCalendar of sky events, no chart
- POST /v1/varshaphalThe Tajik annual chart (varshaphal) for one year
- POST /v1/varshaphal/dinaTajik daily return (dina pravesh) for a day or a short window
Panchang 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.
- POST /v1/panchangPanchang at the birth moment
- GET /v1/panchang/dailyDaily panchang for a date and place, no birth data
- GET /v1/taraTara bala: a daily rating from a birth nakshatra, no chart
- POST /v1/muhurta/{activity}Muhurta: good times to start an activity
Hindu calendar and festivals
Festival dates such as Diwali, fasting days such as Ekadashi, and a month calendar, for any place.
- GET /v1/panchang/monthPanchang calendar for a month, with festivals and fasts
- GET /v1/festivalsHindu festival dates for a year and place
- GET /v1/festivals/{slug}One festival's date for a year and place
- GET /v1/vratsMonthly fasting days (vrats) for a year and place
- GET /v1/eclipsesEclipses (grahan) with local times and sutak
Matching and doshas
Checks people ask about most: marriage compatibility and doshas, each with a plain answer.
Kundli matching
The 36-point score, the 10 South Indian checks (poruthams), and a clear verdict: favorable, workable or difficult.
- POST /v1/matchingMarriage compatibility score (ashtakoot, 36 points)
- POST /v1/matching/nakshatraCompatibility score from two nakshatras, no birth charts
- POST /v1/matching/parasparamEach person's planets placed in the other's chart
- POST /v1/forecast/couple/{theme}Love, career or wealth forecast for a couple
Yogas and doshas
Checks for manglik, kaal sarp and pitra dosha (chart flaws). It also lists the yogas (planet combinations) found or not found, each with its rule.
- POST /v1/yogasYogas: planetary combinations found and not found
- POST /v1/dosha/{name}Doshas: manglik, kaal sarpa, pitra, or the papa count
- POST /v1/sadesatiSade sati: Saturn's 7.5-year transit around the birth Moon
Readings
Text for your users: daily horoscopes, readings, a printable report, remedies, karmic themes and answers to one question.
Daily horoscopes
A daily horoscope for each Moon sign, and personal daily and weekly readings for one birth chart.
- GET /v1/rashi/{sign}/todayDaily reading for a Moon sign, no chart
- POST /v1/reading/dailyDaily reading for a chart
- GET /v1/name/rashiThe Moon sign a name points to
- POST /v1/reading/weeklyWeekly reading for a chart
Readings and reports
Written readings on career, love, wealth and personality, and a printable report.
- POST /v1/reading/sectionsList of reading sections for a chart
- GET /v1/reading/topicsEvery reading topic, no chart needed
- POST /v1/reading/section/{section_id}One section of a reading
- POST /v1/reading/rulesRules this chart triggers, ranked
- POST /v1/forecast/{theme}Love, career or wealth forecast
- POST /v1/summaryPlain-language summary of a chart
- POST /v1/reportFull reading as a printable HTML page
Remedies
Gemstone, rudraksha (sacred bead), mantra, havan (fire ritual), charity and fasting suggestions based on the birth chart.
- POST /v1/reading/section/{section_id}One section of a reading
- POST /v1/remedies/rudrakshaRudraksha recommendation: which bead, and why
- POST /v1/remedies/charityCharity (daan) this chart points to, and why
- POST /v1/remedies/fastingFasting (vrat) this chart points to, and why
Karmic reading
A reading of Rahu and Ketu, two points on the Moon's path, by sign and house. It makes no past-life claims.
- POST /v1/karmaKarma reading: what you bring and where you are headed
- POST /v1/spiritualSpiritual path reading: devotion and release
Prashna (horary)
An answer to one question, such as marriage, work or a lost item, read from the moment it is asked. No birth details are needed.
- POST /v1/prashnaQuestion chart (prashna): one question, read for the moment it is asked
- POST /v1/prashna/kpKP horary: a question read from a number between 1 and 249
- GET /v1/prashna/topicsQuestion chart topics (prashna): what can be asked
Try it free
See an answer with no code
Free tools on this site run on the same API. Enter a birth date, time and place and see the result in your browser.
Which astrology API feature should you call first?
Call the kundli API first: POST /v1/planets turns a birth date, time and place into the birth chart. Dashas, matching, doshas and readings all start from that chart. Some pages need no birth details, such as a daily panchang, a festival calendar or Moon-sign horoscopes. They can start with the panchang, Hindu calendar or horoscope API instead.
Comparing providers first? Read how to choose an astrology API.
How every astrology API feature works
One set of birth details
Most calls take the same birth details: the date, the local time, the place (latitude and longitude) and the time zone. Calendar and sky calls need only a date and a place.
Make your first callEvery plan, every endpoint
Every plan can call all 65 endpoints. Plans differ only in their limits: calls a month, calls a minute and reading credits.
See pricingAnswers that name their rule
Checks such as doshas and yogas explain their answer in plain English and name the rule they used.
Browse the rulebookText length and language
Readings come in a standard or a longer version (detail=expanded). For names and text in another language, send lang=hi for Hindi.
Read the conventions
2 more endpoints are not part of a feature above. You can find each one in the API reference.
- GET /v1/health: Health check.
- GET /v1/meta: Supported options and limits.
Astrology API
Try any feature with a free key
Create an account and a test key, then call any endpoint. Or try a request in the API reference first.
Your first answer
John Doe, New York
- RisingVirgoHast
- SunCancerAshlesha
- MoonTaurusMrigashira
- MarsAriesKrittika
Real API output. A free test key gets the same answer.
01
Test key: 1,000 test calls a month to build with
02
Free plan: 2,000 live calls a month, no card needed
03
Open rules: every rule is published, so you can check any answer