GET
/v1/calculations/kundali
Calculate complete Vedic birth chart (Kundali) with planetary positions, houses, aspects, yogas, and detailed astrological analysis.
Parameters
date
string (ISO 8601)
Birth date and time in ISO 8601 format
2026-02-26T14:30:00Z
latitude
number
Birth location latitude in decimal degrees
27.7172
longitude
number
Birth location longitude in decimal degrees
85.3240
timezone
number
Timezone offset from UTC in hours (default: 5.75)
5.75
ayanamsha
number
Ayanamsa system: 1=Lahiri (default), 3=Raman
1
Request Example
curl -X GET 'https://api.astro-fusion.com/v1/calculations/kundali?date=2026-02-26T14:30:00Z&latitude=27.7172&longitude=85.3240&timezone=5.75&ayanamsha=1' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json'const response = await fetch('https://api.astro-fusion.com/v1/calculations/kundali?date=2026-02-26T14:30:00Z&latitude=27.7172&longitude=85.3240&timezone=5.75&ayanamsha=1', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
});
const kundali = await response.json();import requests
url = 'https://api.astro-fusion.com/v1/calculations/kundali'
params = {
'date': '2026-02-26T14:30:00Z',
'latitude': 27.7172,
'longitude': 85.3240,
'timezone': 5.75,
'ayanamsha': 1
}
headers = {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
response = requests.get(url, params=params, headers=headers)
kundali = response.json()Response Schema
Basic Information
{
"birthDetails": {
"date": "2026-02-26T14:30:00.000Z",
"latitude": 27.7172,
"longitude": 85.3240,
"timezone": 5.75,
"place": "Kathmandu, Nepal"
},
"ayanamsha": {
"value": 24.2,
"system": "Lahiri"
}
}Planetary Positions
{
"planets": [
{
"name": "Sun",
"longitude": 318.5,
"latitude": 0.0,
"distance": 0.983,
"speed": 1.0,
"rashi": "Aquarius",
"rashiLord": "Saturn",
"nakshatra": "Dhanishta",
"nakshatraLord": "Mars",
"house": 9,
"degree": "18°30'",
"retrograde": false
}
// ... more planets
]
}Houses (Bhavas)
{
"houses": [
{
"number": 1,
"name": "Lagna",
"sign": "Taurus",
"signLord": "Venus",
"degree": "15°45'",
"planets": ["Moon"]
}
// ... houses 2-12
]
}Aspects
{
"aspects": [
{
"planet1": "Sun",
"planet2": "Moon",
"aspect": "Trine",
"orb": 2.3,
"strength": "Strong"
}
// ... more aspects
]
}Yogas
{
"yogas": [
{
"name": "Raj Yoga",
"type": "Benefic",
"planets": ["Jupiter", "Venus"],
"strength": "Strong",
"description": "Yoga of power and authority"
}
// ... more yogas
]
}Dasha Information
{
"currentDasha": {
"mahadasha": {
"planet": "Venus",
"startDate": "2020-01-15",
"endDate": "2040-01-15",
"remaining": "14 years"
},
"antardasha": {
"planet": "Sun",
"startDate": "2026-01-01",
"endDate": "2026-07-01",
"remaining": "4 months"
}
}
}Error Responses
400 Bad Request
{
"error": "INVALID_DATE",
"message": "Birth date must be in valid ISO 8601 format",
"code": 400
}401 Unauthorized
{
"error": "INVALID_API_KEY",
"message": "API key is required or invalid",
"code": 401
}429 Too Many Requests
{
"error": "RATE_LIMIT_EXCEEDED",
"message": "API rate limit exceeded. Try again later.",
"code": 429
}