Official SDKs for Every Platform

Choose your language and start building with 188+ Vedic Astrology API endpoints.

🟢

Node.js SDK Most Popular

TypeScript types included
$ npm install kundliapi
const { KundliAPI } = require('kundliapi');
const client = new KundliAPI('YOUR_API_KEY');

const kundli = await client.getBirthChart({
  name: 'Rahul',
  date: '1990-05-15',
  time: '10:30',
  lat: 28.6139,
  lon: 77.2090
});
View Documentation →
🐍

Python SDK

Full async support & type hints
$ pip install kundliapi
from kundliapi import KundliAPI

client = KundliAPI("YOUR_API_KEY")

kundli = client.get_birth_chart(
  name="Rahul",
  date="1990-05-15",
  time="10:30",
  lat=28.6139,
  lon=77.2090
)
View Documentation →
🐘

PHP SDK

Laravel & Symfony compatible
$ composer require kundliapi/kundliapi
use KundliAPI\Client;

$client = new Client('YOUR_API_KEY');

$kundli = $client->getBirthChart([
  'name' => 'Rahul',
  'date' => '1990-05-15',
  'time' => '10:30',
  'lat' => 28.6139,
  'lon' => 77.2090,
]);
View Documentation →

Java SDK

Maven & Gradle support
<!-- Maven -->
<dependency>
  <groupId>com.kundliapi</groupId>
  <artifactId>kundliapi</artifactId>
</dependency>
import com.kundliapi.KundliAPI;

KundliAPI client = new KundliAPI("YOUR_API_KEY");

BirthChart chart = client
  .getBirthChart("Rahul",
    "1990-05-15", "10:30",
    28.6139, 77.2090);
View Documentation →
🤖

Android SDK

Available on Maven Central
// build.gradle
implementation 'com.kundliapi:android-sdk:2.0.0'
val client = KundliAPI("YOUR_API_KEY")

client.getBirthChart(
  name = "Rahul",
  date = "1990-05-15",
  time = "10:30",
  lat = 28.6139,
  lon = 77.2090
) { result -> /* handle */ }
View Documentation →
💎

Ruby SDK

Ruby 2.7+ compatible
$ gem install kundliapi
require 'kundliapi'

client = KundliAPI::Client.new('YOUR_API_KEY')

kundli = client.birth_chart(
  name: 'Rahul',
  date: '1990-05-15',
  time: '10:30',
  lat: 28.6139,
  lon: 77.2090
)
View Documentation →
🔷

C# / .NET SDK

NuGet package
$ dotnet add package KundliAPI
using KundliAPI;

var client = new KundliApiClient("YOUR_API_KEY");

var chart = await client
  .GetBirthChartAsync(
    "Rahul", "1990-05-15",
    "10:30", 28.6139, 77.2090);
View Documentation →

cURL / REST API

Direct API access — no SDK needed
$ curl -X POST https://api.kundliapi.com/v1/birthchart \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Rahul","date":"1990-05-15",...}'
// Response (JSON)
{
  "status": "success",
  "data": {
    "ascendant": "Cancer",
    "moon_sign": "Taurus",
    "sun_sign": "Taurus"
  }
}
View Documentation →

Quick Start — Get Running in 5 Minutes

A complete Node.js example to generate a Kundli birth chart

// 1. Install the SDK
// $ npm install kundliapi

const { KundliAPI } = require('kundliapi');

// 2. Initialize with your API key
const client = new KundliAPI('your_api_key_here');

// 3. Generate a birth chart
async function main() {
  const chart = await client.getBirthChart({
    name: 'Rahul Sharma',
    date: '1990-05-15',
    time: '10:30',
    lat: 28.6139, // Delhi latitude
    lon: 77.2090, // Delhi longitude
    tz: 5.5 // IST timezone offset
  });

  console.log('Ascendant:', chart.ascendant);
  console.log('Moon Sign:', chart.moon_sign);
  console.log('Planets:', chart.planets);

  // 4. Get Dasha periods
  const dasha = await client.getMahaDasha({
    date: '1990-05-15',
    time: '10:30',
    lat: 28.6139, lon: 77.2090, tz: 5.5
  });

  console.log('Current Dasha:', dasha.current);
}

main().catch(console.error);

Authentication

All API requests require an API key. Here's how to get started:

1

Sign Up

Create a free account at kundliapi.com — no credit card required.

2

Get Your API Key

Go to your Dashboard and copy your unique API key from the API Keys section.

3

Start Building

Pass the key via the Authorization header or apiKey query param.

Ready to Build?

Get your free API key and start integrating Vedic Astrology into your app today.

Get API Key — Free Read the Docs