Authentication
All API requests require authentication via an API key. Include your API key in the X-Api-Key header with every request.
Important: Your API key is linked to verified domains/IPs. Requests from unverified origins will be rejected. Add domains and IPs in your Dashboard.
Base Parameters
Most astrology endpoints require the following birth data parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
day | Integer | Required | Birth day (1-31) |
month | Integer | Required | Birth month (1-12) |
year | Integer | Required | Birth year (e.g., 1990) |
hour | Integer | Required | Birth hour in 24h format (0-23) |
min | Integer | Required | Birth minute (0-59) |
lat | Float | Required | Birth latitude (e.g., 28.6139) |
lon | Float | Required | Birth longitude (e.g., 77.2090) |
tzone | Float | Required | Timezone offset (e.g., 5.5 for IST) |
Error Handling
The API returns standard HTTP status codes:
| Code | Meaning |
|---|---|
200 | Success |
400 | Bad Request — missing or invalid parameters |
401 | Unauthorized — invalid or missing API key |
403 | Forbidden — domain/IP not verified |
429 | Rate limit exceeded |
500 | Internal server error |
Panchang
Complete Hindu Panchang data including Tithi, Nakshatra, Yoga, Karana, and timings.
Returns complete Panchang data for the given date and location.
Request Body:
Response includes:
Tithi, Nakshatra, Yoga, Karana, Sunrise, Sunset, Moonrise, Moonset, Rahu Kaal, Gulika Kaal, Yamaganda, Abhijit Muhurat, etc.
Returns panchang data for the entire month.
Returns Choghadiya timings for the day — auspicious and inauspicious periods.
Muhurat Timings
Returns planetary Hora timings for the day.
Astro Data
Get basic and extended astrological data for a birth chart.
Returns ascendant sign, nakshatra, deity, and Moon sign information.
Example Request (cURL):
Returns extended astrological details including Ascendant lord, Rashi lord, Varna, Yoni, Gan, Nadi, etc.
Planet Positions
Get planetary positions, dignity, aspects, and house placements.
Returns positions of all 9 planets (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu) with sign, degree, nakshatra, house, and retrograde status.
Returns extended planet data including nakshatra lord, sub lord, and sub-sub lord.
Dasha System
Vimshottari and Yogini Dasha periods with precise calculations.
Returns all Vimshottari Maha Dasha periods with start/end dates and current dasha indication.
Returns Antar Dasha periods within each Maha Dasha.
Returns current running Chara (Jaimini) Dasha.
Returns Yogini Dasha periods — 36-year cycle system.
Dosha Analysis
Check major doshas in a birth chart.
Returns Mangal (Mars) Dosha analysis with percentage and detailed description.
Returns Kaal Sarp Dosha analysis — Rahu/Ketu axis check.
Returns Pitra Dosha analysis — ancestral karma effects.
Returns Sadhesati (Saturn transit) analysis — current phase and dates.
Birth Charts
Generate various divisional charts (D-1 to D-60).
Returns Lagna (Ascendant) chart data with planet placements in houses.
Returns Navamsa chart data — used for marriage and dharma analysis.
Returns Bhava Chalit chart — houses based on actual house cusps.
Kundli Matching
Ashtakoota and other matching systems for marriage compatibility.
Returns 8-fold matching (Gun Milan) score out of 36 points.
Request Body:
Response includes scores for: Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, Nadi.
Returns 10-fold matching used in South Indian astrology.
KP Astrology
Krishnamurti Paddhati system endpoints.
Returns KP house cusps with sign lord, star lord, and sub lord.
Returns planets with sign lord, star lord, sub lord — KP style.
Numerology
Complete numerology analysis endpoints.
Returns birth number, life path number, name analysis.
Additional Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
name | String | Required | Full name for numerology analysis |
Returns Lo Shu Grid (magic square) analysis based on birth date.
Western Astrology — Natal
Tropical/Western astrology calculations using Placidus house system.
Returns Western natal chart with tropical zodiac positions, aspects, house placements, element/modality analysis.
Response includes:
Sun sign, Moon sign, Rising sign, all planet positions in tropical zodiac, major & minor aspects with orbs, house system data, element balance, hemisphere emphasis.
Western — Synastry & Composite
Compares two birth charts for relationship compatibility. Returns inter-aspects between both charts.
Additional Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
day2, month2, year2 | Integer | Required | Second person's birth date |
hour2, min2 | Integer | Required | Second person's birth time |
latitude2, longitude2 | Float | Required | Second person's birth location |
timezone2 | Float | Required | Second person's timezone |
Returns midpoint composite chart of two people — the relationship chart. Same parameters as Synastry.
Western — Transits & Progressions
Returns Solar Return chart for a specific year (birthday chart). Add targetYear to request body.
Returns progressed chart positions (day-for-a-year method).
Returns current planetary positions in tropical zodiac.
Returns moon phases for a given month/year with New Moon, Full Moon, and quarter phases.
Western — Reports
Returns detailed personality analysis based on Western chart — Sun, Moon, Rising, elements, and aspects.
Returns romantic forecast based on Venus, Mars, 7th house and relationship aspects.
Returns karma and destiny analysis based on Saturn, Nodes, and 12th house.
Tarot Card API
Complete 78-card Tarot engine with multiple spread types.
Returns Past, Present, Future reading with full card interpretations.
Optional Parameters:
| Parameter | Type | Description |
|---|---|---|
question | String | Your question for the reading |
seed | Integer | Seed for reproducible readings |
Returns full Celtic Cross spread — the most comprehensive single-question reading.
Returns Yes, No, or Maybe answer with supporting card and explanation.
Returns today's daily tarot card with guidance message.
Returns complete deck — 22 Major Arcana + 56 Minor Arcana with all meanings.
Varshaphal (Annual Horoscope)
Vedic Solar Return / Tajika astrology system for annual predictions.
Returns annual horoscope chart with Muntha, Panchadhikari, and Harsha Bala. Add targetYear to request body.
Returns Tajika yogas: Ithasala, Easarapha, Nakta, Yamaya, Manaú, Kamboola.
Returns 16 Sahams — Punya, Vidya, Yashas, Mitra, and more.
Gochar (Transit Analysis)
Personalized transit analysis with Vedha (obstruction) logic.
Returns current transits relative to your natal Moon sign with Vedha analysis and benefic/malefic determination.
Returns detailed Saturn transit analysis — Sade Sati phase, Dhaiya, Kantaka, with start/end dates and remedies.
Returns Jupiter (Guru) transit analysis with effects based on house from Moon.
Lal Kitab
Complete Lal Kitab astrology system with unique remedies.
Returns Lal Kitab chart with Pakka Ghar assignments and sleeping/awakened planet status.
Returns planet-specific remedies — materials, donations, rituals based on house placements.
Returns 6 planetary debts: Pitru Rin, Matru Rin, Stri Rin, Swa Rin, Bandhu Rin, Sasur Rin with symptoms and remedies.
Biorhythm
Physical, Emotional, Intellectual, and extended cycles.
Returns 6 biorhythm cycles: Physical (23d), Emotional (28d), Intellectual (33d), Intuitive (38d), Aesthetic (43d), Spiritual (53d).
Compare biorhythm cycles between two people. Uses day2/month2/year2 parameters.
Human Design
BodyGraph, Type, Strategy, Authority, Gates, Channels, and Profile.
Returns complete Human Design analysis: Type (Generator, Projector, Manifestor, Reflector, MG), Strategy, Authority, Profile, all defined/undefined Centers, active Channels, Gates, and Incarnation Cross.
Returns simplified summary: Type, Strategy, Authority, Profile, defined/undefined centers list.
Yoga Combinations
Identify powerful yoga combinations in a birth chart — Raj Yoga, Dhan Yoga, Panch Mahapurush, and Moon-based yogas.
Returns all yoga combinations present in a birth chart — including Raj Yoga, Dhan Yoga, Panch Mahapurush Yoga, Chandra Yoga, and more.
Example Request (cURL):
Returns Raj Yoga analysis — combinations of Kendra and Trikona lords that indicate power, authority, and success.
Returns Dhan Yoga (wealth yoga) analysis — planetary combinations indicating financial prosperity and material gains.
Returns Panch Mahapurush Yoga analysis — Ruchaka, Bhadra, Hamsa, Malavya, and Sasa yogas formed by Mars, Mercury, Jupiter, Venus, and Saturn in Kendra in own/exaltation sign.
Returns Moon-based yoga analysis — Sunaphа, Anaphа, Durudhara, Kemadruma, Gajakesari, and other Chandra yogas.
Muhurat Finder
Find auspicious dates and times (Muhurat) for important life events — marriage, housewarming, business, travel, and more.
Returns auspicious dates for marriage (Vivah Muhurat) within the given date range.
Request Body:
Muhurat Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
start_year | Integer | Required | Start year of the search range |
start_month | Integer | Required | Start month (1-12) |
start_day | Integer | Required | Start day (1-31) |
end_year | Integer | Required | End year of the search range |
end_month | Integer | Required | End month (1-12) |
end_day | Integer | Required | End day (1-31) |
lat | Float | Required | Location latitude |
lon | Float | Required | Location longitude |
tzone | Float | Required | Timezone offset (e.g., 5.5 for IST) |
Returns auspicious dates for housewarming (Grihapravesh) ceremony within the given date range.
Returns auspicious dates for naming ceremony (Namkaran) within the given date range.
Returns auspicious dates for business or shop opening within the given date range.
Returns auspicious dates for travel within the given date range.
Returns auspicious dates for vehicle purchase within the given date range.
Returns auspicious dates for property purchase within the given date range.
Returns auspicious dates for Mundan (first head shaving) ceremony within the given date range.
Returns auspicious dates for Annaprashan (first rice feeding) ceremony within the given date range.
Check if a specific date and time is auspicious for general activities.
Request Body:
Note: This endpoint uses standard birth-data parameters (year, month, day, hour, min, lat, lon, tzone) instead of the date-range parameters used by other muhurat endpoints.
Need More Details?
This documentation covers the most commonly used endpoints. For a complete list of all 203+ endpoints, test them directly from your dashboard or contact our support.