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.
How to Generate a PDF Report
KundliAPI is a data API — every endpoint above returns JSON (planet positions, house placements, dasha periods, dosha analysis, etc.), not a ready-made PDF file. There is no "generate PDF" endpoint, and that's by design: the PDF layout and design is something you build on your own side, using the JSON this API gives you.
We intentionally don't offer a hosted "give us the data, we'll email you a PDF" endpoint, because any PDF we generated for you would carry KundliAPI branding. Drawing/designing it yourself means the final report carries your own brand, not ours.
The workflow
1. Fetch the data. Call the endpoints you need for the same birth details — e.g. /api/astro/get_astro_data, /api/planets/, /api/charts/lagna_chart, /api/charts/navamsa_chart, /api/dasha/maha_dasha, /api/dosha/mangal_dosha — and combine the JSON responses.
2. Render that JSON into a PDF, using your own code. Two common approaches:
| Approach | How it works | Typical libraries |
|---|---|---|
| Draw the PDF programmatically | Your code places text, tables, and lines at specific coordinates directly onto a blank PDF canvas. | PDFKit (Node.js), ReportLab (Python), iText (Java), QuestPDF (.NET) |
| HTML → PDF conversion | Design the report as a normal HTML/CSS page, inject the API's JSON values into it, then "print" that page to a PDF using a headless browser. | Puppeteer / Playwright (Chromium), wkhtmltopdf, WeasyPrint |
The HTML → PDF route is usually easier to start with — you can design and preview the report visually in a normal browser before exporting it.
3. Drawing the Kundli chart itself. The API only tells you which planet sits in which house as JSON (e.g. { "house": 1, "planet": "Sun" }) — it does not return a chart image. You need to draw the diamond shape (North Indian style) or the fixed 12-box grid (South Indian style) yourself, then place each planet's abbreviation into the correct box based on that house data. This is the one part that takes real design effort — everything else is just laying out text and tables.
In short: fetch the numbers from KundliAPI, then draw/design the PDF yourself with a PDF or HTML-to-PDF library of your choice — that way the final report reflects your own brand, not ours.
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.