API Documentation | KundliAPI.com

Authentication

All API requests require authentication via an API key. Include your API key in the X-Api-Key header with every request.

// Include in all API requests
headers: {
  'Content-Type': 'application/json',
  'X-Api-Key': 'your_api_key_here'
}
      

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.

POST/api/panchang/panchangGet Panchang for date

Returns complete Panchang data for the given date and location.

Request Body:

{ "day": 15, "month": 6, "year": 2024, "hour": 6, "min": 0, "lat": 28.6139, "lon": 77.2090, "tzone": 5.5 }

Response includes:

Tithi, Nakshatra, Yoga, Karana, Sunrise, Sunset, Moonrise, Moonset, Rahu Kaal, Gulika Kaal, Yamaganda, Abhijit Muhurat, etc.

POST/api/panchang/monthly_panchangMonthly Panchang

Returns panchang data for the entire month.

POST/api/panchang/choghadiyaChoghadiya Muhurat

Returns Choghadiya timings for the day — auspicious and inauspicious periods.

Muhurat Timings

POST/api/panchang/horaHora Muhurat

Returns planetary Hora timings for the day.

Astro Data

Get basic and extended astrological data for a birth chart.

POST/api/astro/get_astro_dataBasic Astro Data

Returns ascendant sign, nakshatra, deity, and Moon sign information.

Example Request (cURL):

curl -X POST https://kundliapi.com/api/astro/get_astro_data \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: your_api_key_here" \
  -d '{"day":15,"month":6,"year":1990,"hour":10,"min":30,"lat":28.6139,"lon":77.209,"tzone":5.5}'

POST/api/astro/astro_detailsExtended Astro Details

Returns extended astrological details including Ascendant lord, Rashi lord, Varna, Yoni, Gan, Nadi, etc.

Planet Positions

Get planetary positions, dignity, aspects, and house placements.

POST/api/planets/All Planet Positions

Returns positions of all 9 planets (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu) with sign, degree, nakshatra, house, and retrograde status.

POST/api/planets/extendedExtended Planets

Returns extended planet data including nakshatra lord, sub lord, and sub-sub lord.

Dasha System

Vimshottari and Yogini Dasha periods with precise calculations.

POST/api/dasha/maha_dashaMaha Dasha

Returns all Vimshottari Maha Dasha periods with start/end dates and current dasha indication.

POST/api/dasha/antar_dashaAntar Dasha

Returns Antar Dasha periods within each Maha Dasha.

POST/api/dasha/char_dasha_currentChara Dasha (Current)

Returns current running Chara (Jaimini) Dasha.

POST/api/dasha/yogini_dashaYogini Dasha

Returns Yogini Dasha periods — 36-year cycle system.

Dosha Analysis

Check major doshas in a birth chart.

POST/api/dosha/mangal_doshaMangal Dosha

Returns Mangal (Mars) Dosha analysis with percentage and detailed description.

POST/api/dosha/kaalsarp_doshaKaal Sarp Dosha

Returns Kaal Sarp Dosha analysis — Rahu/Ketu axis check.

POST/api/dosha/pitra_doshaPitra Dosha

Returns Pitra Dosha analysis — ancestral karma effects.

POST/api/dosha/sadhesatiSadhesati

Returns Sadhesati (Saturn transit) analysis — current phase and dates.

Birth Charts

Generate various divisional charts (D-1 to D-60).

POST/api/charts/lagna_chartLagna Chart (D-1)

Returns Lagna (Ascendant) chart data with planet placements in houses.

POST/api/charts/navamsa_chartNavamsa Chart (D-9)

Returns Navamsa chart data — used for marriage and dharma analysis.

POST/api/charts/chalit_chartChalit Chart

Returns Bhava Chalit chart — houses based on actual house cusps.

Kundli Matching

Ashtakoota and other matching systems for marriage compatibility.

POST/api/matching/ashtakootAshtakoota Matching

Returns 8-fold matching (Gun Milan) score out of 36 points.

Request Body:

{
  "boy": { "day": 15, "month": 6, "year": 1990, "hour": 10, "min": 30, "lat": 28.6139, "lon": 77.209, "tzone": 5.5 },
  "girl": { "day": 20, "month": 3, "year": 1992, "hour": 14, "min": 15, "lat": 28.6139, "lon": 77.209, "tzone": 5.5 }
}

Response includes scores for: Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, Nadi.

POST/api/matching/dashakootDashakoot Matching

Returns 10-fold matching used in South Indian astrology.

KP Astrology

Krishnamurti Paddhati system endpoints.

POST/api/kp/cuspsKP House Cusps

Returns KP house cusps with sign lord, star lord, and sub lord.

POST/api/kp/planetsKP Planets

Returns planets with sign lord, star lord, sub lord — KP style.

Numerology

Complete numerology analysis endpoints.

POST/api/numerology/numero_dataNumerology Data

Returns birth number, life path number, name analysis.

Additional Parameters:

Parameter	Type	Required	Description
`name`	String	Required	Full name for numerology analysis

POST/api/numerology/lo_shu_gridLo Shu Grid

Returns Lo Shu Grid (magic square) analysis based on birth date.

Need More Details?

This documentation covers the most commonly used endpoints. For a complete list of all 98+ endpoints, test them directly from your dashboard or contact our support.

Get API Access Contact Support