Kundali API - DivineAPI

Free Kundali API for developers. 23+ REST endpoints for Vedic birth charts, planetary positions, dashas, doshas, yogas and remedies. Plain JSON over HTTPS, 25 languages, no SDK required.

---

What is the Kundali API?

The Kundali API by DivineAPI is a suite of 23+ REST endpoints for Vedic birth chart (kundli) generation and analysis. Give a birth date, time and location, get back the full Vedic profile: planets, houses, nakshatras, dashas, doshas, yogas, divisional charts and remedies. Plain JSON over HTTPS, 25 languages, no SDK required.

Part of the broader DivineAPI platform (300+ astrology, horoscope, tarot and numerology endpoints).

Why choose DivineAPI's Kundali API?

• 23+ REST endpoints covering every major Vedic birth-chart calculation
• Accurate Vedic calculations using authoritative ephemeris and classical astrology algorithms
• Global coverage: any city, any latitude/longitude, any timezone
• 25-language output: English, Hindi, Spanish, French, Arabic, Chinese, and more
• No SDK lock-in: plain JSON over HTTPS, works with every language
• Live status page: uptime monitored at status.divineapi.com
• Postman collection included: import and run in seconds

All endpoints in the Kundali API

Charts & Positions

Endpoint	Docs
Basic Astrological Details	link
Planetary Positions	link
Horoscope Charts	link
Ascendant Report	link
Bhava Kundli	link
Sudarshana Chakra	link

Dashas

Endpoint	Docs
Vimshottari Dasha	link
Kaal Chakra Dasha	link
Yogini Dasha	link
Dasha Analysis	link

Doshas

Endpoint	Docs
Kaal Sarpa Dosha	link
Manglik Dosha	link
Sadhe Sati	link
Pitra Dosha	link

Yogas & Deep Analysis

Endpoint	Docs
Yogas	link
Jaimini Astrology	link
Planet Analysis	link
Bhinnashtakvarga	link
Shadbala	link

Remedies & Utilities

Endpoint	Docs
Gemstone Suggestions	link
Ghata Chakra	link
Composite Friendship	link
Kundali Transit	link

Full reference, request/response samples, and live "try-it" console → developers.divineapi.com/indian-api/kundli-api

---

Quick start

1. Get your API key → divineapi.com/register (14-day free trial, no credit card)
2. Make your first call - see the walkthrough below
3. Browse all endpoints → developers.divineapi.com/indian-api/kundli-api

---

Walkthrough: Basic Astrological Details

A good starting point for any Kundli-based app. Submit birth details, get back the core astrological profile: sunsign, moonsign, nakshatra, tithi, yoga, karana, rashi, varna, gana, nadi, ayanamsha and more.

POST https://astroapi-3.divineapi.com/indian-api/v3/basic-astro-details

Authenticate with a Bearer token in the Authorization header and pass api_key in the request body (both required).

Request body

Parameter	Type	Required	Description	Example
api_key	string	✓	Your DivineAPI key	YOUR_API_KEY
full_name	string	✓	Person's full name	Rahul Kumar
day	integer	✓	Date of birth (day)	24
month	integer	✓	Month of birth	5
year	integer	✓	Year of birth	2023
hour	integer	✓	Birth hour (24-h clock)	14
min	integer	✓	Birth minute	40
sec	integer	✓	Birth second	43
gender	string	✓	Gender	male
place	string	✓	Place of birth	New Delhi
lat	float	✓	Latitude	28.7041
lon	float	✓	Longitude	77.1025
tzone	float	✓	Timezone offset from UTC	5.5
lan	string	-	Language code (default en)	en

Full docs → developers.divineapi.com/indian-api/kundli-api/basic-astrological-details/basic-astrological-details-api

Sample response

{
  "success": 1,
  "data": {
    "full_name": "Rahul Kumar",
    "year": "2023",
    "month": "05",
    "day": "24",
    "hour": "14",
    "minute": "40",
    "gender": "male",
    "place": "New Delhi",
    "latitude": "28.7041",
    "longitude": "77.1025",
    "timezone": "5.5",
    "sunrise": "2023-05-24 05:25:10",
    "sunset": "2023-05-24 19:05:42",
    "tithi": "Chaturthi",
    "paksha": "Shukla",
    "paya": {
      "type": "Silver",
      "result": "Best"
    },
    "sunsign": "Taurus",
    "moonsign": "Cancer",
    "rashi_akshar": "ही, हू, हे, हो, डा, डी, डू, डे, डो",
    "chandramasa": "Jyeshta",
    "tatva": "Watery",
    "prahar": 5,
    "nakshatra": "Pushya",
    "vaar": "Wednesday",
    "varna": "Brahmin",
    "vashya": "Chatushpad",
    "yoni": "Mesh",
    "gana": "Deva",
    "nadi": "Adi",
    "yoga": "Harshana",
    "karana": "Vishti",
    "ayanamsha": "24.1234567",
    "yunja": "Madhya"
  }
}

---

Code examples

cURL

curl -X POST "https://astroapi-3.divineapi.com/indian-api/v3/basic-astro-details" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "api_key=YOUR_API_KEY" \
  --data-urlencode "full_name=Rahul Kumar" \
  --data-urlencode "day=24" \
  --data-urlencode "month=5" \
  --data-urlencode "year=2023" \
  --data-urlencode "hour=14" \
  --data-urlencode "min=40" \
  --data-urlencode "sec=43" \
  --data-urlencode "gender=male" \
  --data-urlencode "place=New Delhi" \
  --data-urlencode "lat=28.7041" \
  --data-urlencode "lon=77.1025" \
  --data-urlencode "tzone=5.5"

Python (requests)

import requests

url = "https://astroapi-3.divineapi.com/indian-api/v3/basic-astro-details"

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/x-www-form-urlencoded",
}

payload = {
    "api_key":   "YOUR_API_KEY",
    "full_name": "Rahul Kumar",
    "day":       24,
    "month":     5,
    "year":      2023,
    "hour":      14,
    "min":       40,
    "sec":       43,
    "gender":    "male",
    "place":     "New Delhi",
    "lat":       28.7041,
    "lon":       77.1025,
    "tzone":     5.5,
}

response = requests.post(url, headers=headers, data=payload)
print(response.json())

JavaScript (browser, fetch)

const url = "https://astroapi-3.divineapi.com/indian-api/v3/basic-astro-details";

const body = new URLSearchParams({
  api_key:   "YOUR_API_KEY",
  full_name: "Rahul Kumar",
  day:   24, month: 5,  year:  2023,
  hour:  14, min:   40, sec:   43,
  gender: "male", place: "New Delhi",
  lat:  28.7041, lon: 77.1025, tzone: 5.5,
});

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type":  "application/x-www-form-urlencoded",
  },
  body,
});

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

Node.js (fetch, Node 18+)

// Node.js 18+ ships with fetch built-in, no dependencies needed.

async function getBasicAstroDetails() {
  const url = "https://astroapi-3.divineapi.com/indian-api/v3/basic-astro-details";

  const body = new URLSearchParams({
    api_key:   "YOUR_API_KEY",
    full_name: "Rahul Kumar",
    day:   24, month: 5,  year:  2023,
    hour:  14, min:   40, sec:   43,
    gender: "male", place: "New Delhi",
    lat:  28.7041, lon: 77.1025, tzone: 5.5,
  });

  const res = await fetch(url, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type":  "application/x-www-form-urlencoded",
    },
    body,
  });

  const data = await res.json();
  console.log(data);
}

getBasicAstroDetails();

PHP (curl)

<?php
$url = "https://astroapi-3.divineapi.com/indian-api/v3/basic-astro-details";

$payload = http_build_query([
    "api_key"   => "YOUR_API_KEY",
    "full_name" => "Rahul Kumar",
    "day"       => 24,
    "month"     => 5,
    "year"      => 2023,
    "hour"      => 14,
    "min"       => 40,
    "sec"       => 43,
    "gender"    => "male",
    "place"     => "New Delhi",
    "lat"       => 28.7041,
    "lon"       => 77.1025,
    "tzone"     => 5.5,
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY",
    "Content-Type: application/x-www-form-urlencoded",
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Go (net/http)

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    endpoint := "https://astroapi-3.divineapi.com/indian-api/v3/basic-astro-details"

    form := url.Values{}
    form.Set("api_key",   "YOUR_API_KEY")
    form.Set("full_name", "Rahul Kumar")
    form.Set("day",       "24")
    form.Set("month",     "5")
    form.Set("year",      "2023")
    form.Set("hour",      "14")
    form.Set("min",       "40")
    form.Set("sec",       "43")
    form.Set("gender",    "male")
    form.Set("place",     "New Delhi")
    form.Set("lat",       "28.7041")
    form.Set("lon",       "77.1025")
    form.Set("tzone",     "5.5")

    req, _ := http.NewRequest("POST", endpoint, strings.NewReader(form.Encode()))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type",  "application/x-www-form-urlencoded")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

---

Other APIs by DivineAPI

---

Resources

• Full documentation → developers.divineapi.com/indian-api/kundli-api
• Parent platform README → github.com/DivineAPI/astrology-api
• API status → status.divineapi.com
• Postman collection → Run in Postman
• Changelog → developers.divineapi.com/changelog
• Support → admin@divineapi.com

---

License & Usage

Code samples on this page are free to copy into your own projects, no attribution required. Marketing copy, logos, and the DivineAPI name are © 2026 DivineAPI, all rights reserved.

For the terms that govern the API service itself, see divineapi.com/terms.

Contact

Questions, feature requests or partnership enquiries → admin@divineapi.com