Astrology API features
The astrology API has 42 endpoints in 13 features. Each feature below lists its endpoints. Its own page shows a real response and the rules behind it.
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 such as the navamsa (D9).
- 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)
Planetary strength
Shadbala, the six-part strength score, and ashtakavarga points, with each part of the score.
- POST /v1/shadbalaPlanet and house strength (shadbala and bhava bala)
- POST /v1/ashtakavargaAshtakavarga: strength points for each sign
Jaimini astrology
Chara karakas, chara dasha, sign aspects and argala from the Jaimini system.
Read more about Jaimini astrology
Timing
When things happen: planetary periods, transits and the Hindu calendar.
Dashas (planetary periods)
Vimshottari and Yogini 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)
Transits and forecasts
Where the planets are now against a birth chart, dated forecasts, and sign change and retrograde dates.
- POST /v1/transitsCurrent transits judged 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
Panchang and muhurat
The Hindu calendar for any date and place: lunar day, nakshatra, rahu kaal and good times.
- 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
Matching and doshas
Checks people ask about most: marriage compatibility and doshas, each with a plain answer.
Kundli matching
The 36-point score, the southern checks, 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
Manglik, kaal sarp and pitra dosha checks, and yogas 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 and karmic themes.
Daily horoscopes
A daily horoscope for each Moon sign, and a personal daily reading for one birth chart.
- GET /v1/rashi/{sign}/todayDaily reading for a Moon sign, no chart
- POST /v1/reading/dailyDaily 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
- POST /v1/reading/section/{section_id}One section of a reading
- POST /v1/reading/rulesChart rules from the built-in text, 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, mantra and havan suggestions based on the birth chart.
Read more about RemediesKarmic reading
A reading of Rahu and Ketu, the Moon's nodes, by sign and house. It makes no past-life claims.
Read more about Karmic reading
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 42 endpoints. Plans differ only in how many calls you can make.
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). Names and text can also come in Hindi (lang=hi).
Read the conventions
Two more endpoints help you build: GET /v1/meta lists the options the API supports, and GET /v1/health is a free status check. Both are in the API reference.
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.
01
A free test key, with 1,000 requests a month
02
Try any endpoint in your browser first
03
Every rule published, so you can check any answer