Kundli API

Overview

The Kundli API generates a comprehensive Vedic birth chart (Janam Kundli) using Swiss Ephemeris calculations with Lahiri ayanamsa. It returns:

All 9 planetary positions (Sun through Ketu) with degrees, signs, and nakshatras
12 house cusps with sign placements
Ascendant (Lagna) and Moon sign details
Planetary aspects and conjunctions
Major yogas formed in the chart
Vimshottari Dasha balance at birth

Request

cURL

curl -X POST "https://api.vedika.io/v2/astrology/kundli" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "datetime": "1990-05-15T10:30:00+05:30",
    "latitude": 28.6139,
    "longitude": 77.2090,
    "timezone": "Asia/Kolkata",
    "ayanamsa": "lahiri"
  }'

JavaScript

const response = await fetch('https://api.vedika.io/v2/astrology/kundli', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    datetime: '1990-05-15T10:30:00+05:30',
    latitude: 28.6139,
    longitude: 77.2090,
    timezone: 'Asia/Kolkata',
    ayanamsa: 'lahiri'
  })
});

const data = await response.json();
console.log(data);

Python

import requests

response = requests.post(
    'https://api.vedika.io/v2/astrology/kundli',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY'
    },
    json={
        'datetime': '1990-05-15T10:30:00+05:30',
        'latitude': 28.6139,
        'longitude': 77.2090,
        'timezone': 'Asia/Kolkata',
        'ayanamsa': 'lahiri'
    }
)

data = response.json()
print(data)

Parameters

Parameter	Type	Required	Description
`datetime`	string	Required	Birth date and time in ISO 8601 format (e.g., "1990-05-15T10:30:00+05:30")
`latitude`	number	Required	Birth location latitude (-90 to 90)
`longitude`	number	Required	Birth location longitude (-180 to 180)
`timezone`	string	Optional	IANA timezone (e.g., "Asia/Kolkata"). Defaults to UTC offset from datetime.
`ayanamsa`	string	Optional	Ayanamsa system: "lahiri" (default), "raman", "krishnamurti", "yukteshwar"

Response

{
  "success": true,
  "data": {
    "ascendant": {
      "sign": "Cancer",
      "signIndex": 4,
      "degree": 15.234,
      "nakshatra": "Pushya",
      "nakshatraPada": 2,
      "lord": "Moon"
    },
    "planets": [
      {
        "name": "Sun",
        "sign": "Taurus",
        "signIndex": 2,
        "degree": 0.639,
        "nakshatra": "Krittika",
        "nakshatraPada": 4,
        "house": 11,
        "isRetrograde": false,
        "signLord": "Venus",
        "nakshatraLord": "Sun"
      },
      {
        "name": "Moon",
        "sign": "Aquarius",
        "signIndex": 11,
        "degree": 12.456,
        "nakshatra": "Shatabhisha",
        "nakshatraPada": 2,
        "house": 8,
        "isRetrograde": false,
        "signLord": "Saturn",
        "nakshatraLord": "Rahu"
      },
      // ... Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu
    ],
    "houses": [
      { "house": 1, "sign": "Cancer", "signIndex": 4, "degree": 15.234, "lord": "Moon" },
      { "house": 2, "sign": "Leo", "signIndex": 5, "degree": 12.567, "lord": "Sun" },
      { "house": 3, "sign": "Virgo", "signIndex": 6, "degree": 10.891, "lord": "Mercury" },
      // ... houses 4-12
    ],
    "aspects": [
      { "planet1": "Sun", "planet2": "Saturn", "aspect": "opposition", "orb": 2.3 },
      { "planet1": "Moon", "planet2": "Mars", "aspect": "trine", "orb": 1.8 }
    ],
    "yogas": [
      { "name": "Budh-Aditya Yoga", "planets": ["Sun", "Mercury"], "house": 11 },
      { "name": "Gajakesari Yoga", "planets": ["Moon", "Jupiter"], "strength": "moderate" }
    ],
    "dashaBalance": {
      "currentDasha": "Rahu",
      "startDate": "1985-03-21",
      "endDate": "2003-03-21",
      "balanceYears": 13,
      "balanceMonths": 2,
      "balanceDays": 6
    }
  },
  "metadata": {
    "requestId": "req_kundli_abc123",
    "calculatedAt": "2026-01-07T12:00:00Z",
    "ayanamsaUsed": "lahiri",
    "ayanamsaValue": 24.123,
    "cost": 0.006
  }
}

Response Fields

Ascendant Object

Field	Type	Description
`sign`	string	Zodiac sign name
`signIndex`	number	Sign index (1-12, Aries=1)
`degree`	number	Degree within sign (0-30)
`nakshatra`	string	Nakshatra name
`nakshatraPada`	number	Pada (1-4)
`lord`	string	Sign lord planet

Planet Object

Field	Type	Description
`name`	string	Planet name
`sign`	string	Current zodiac sign
`degree`	number	Degree within sign
`nakshatra`	string	Current nakshatra
`house`	number	House placement (1-12)
`isRetrograde`	boolean	Whether planet is retrograde

Error Handling

{
  "success": false,
  "error": {
    "code": "INVALID_COORDINATES",
    "message": "Latitude must be between -90 and 90",
    "field": "latitude"
  }
}

Error Codes

Code	HTTP Status	Description
`INVALID_DATETIME`	400	Invalid date/time format
`INVALID_COORDINATES`	400	Latitude/longitude out of range
`INVALID_AYANAMSA`	400	Unknown ayanamsa system
`UNAUTHORIZED`	401	Invalid or missing API key
`INSUFFICIENT_BALANCE`	402	Not enough credits
`RATE_LIMITED`	429	Too many requests

SDK Examples

JavaScript SDK

import { VedikaClient } from '@anthropic/vedika-sdk';

const client = new VedikaClient('YOUR_API_KEY');

const kundli = await client.astrology.kundli({
  datetime: '1990-05-15T10:30:00+05:30',
  latitude: 28.6139,
  longitude: 77.2090
});

console.log(kundli.data.ascendant);
console.log(kundli.data.planets);

Python SDK

from vedika import VedikaClient

client = VedikaClient('YOUR_API_KEY')

kundli = client.astrology.kundli(
    datetime='1990-05-15T10:30:00+05:30',
    latitude=28.6139,
    longitude=77.2090
)

print(kundli.data.ascendant)
print(kundli.data.planets)

Related Endpoints

POST /birth-chart

Basic birth chart with planetary positions

POST /navamsha

D9 divisional chart for marriage

POST /vimshottari-dasha

Full dasha periods timeline