API Documentation

Authentication

All API endpoints require authentication via an API Key. You must include your API Key in the headers of every request.

You can generate an API key by creating an account on the Dashboard.

POST /api/astro

Calculates Sayana, Nirayana (using Lahiri Ayanamsa), and Vedic astrological details (Rashi, Nakshatra, Bhav) for 12 celestial bodies.

Request Parameters

Code Examples

{
  "year": 1990,
  "month": 1,
  "day": 1,
  "hour": 12,
  "minute": 0,
  "latitude": 28.6139,
  "longitude": 77.2090,
  "timezoneOffset": 5.5
}

Example Response (200 OK)

{
  "julianDay": 2447893.0004068285,
  "ayanamsa": {
    "name": "Lahiri",
    "value": 23.71358700018593
  },
  "planets": {
    "lagna": {
      "name": "लग्न",
      "sayana": 143.5309604453243,
      "nirayana": 119.33990823020002,
      "rashi": 4,
      "rashiName": "कर्क",
      "nakshatra": 9,
      "nakshatraName": "आश्लेषा",
      "nakshatra_swami": "बुध",
      "bhav": 1
    },
    "sun": {
      "name": "सूर्य",
      "sayana": 280.7226017004455,
      "nirayana": 257.0090147002596,
      "latitude": 0.00030501865955113915,
      "rashi": 9,
      "rashiName": "धनु",
      "nakshatra": 20,
      "nakshatraName": "पूर्वाषाढ़ा",
      "nakshatra_swami": "शुक्र",
      "bhav": 6
    },
    ...
  }
}
            

POST /api/varga

Calculates all 16 standard Parashari divisional charts (Shodashvarga).

Request Parameters

Same as /api/astro, plus the following optional parameter:

Code Examples

{
  "year": 1990,
  "month": 1,
  "day": 1,
  "hour": 12,
  "minute": 0,
  "latitude": 28.6139,
  "longitude": 77.2090,
  "timezoneOffset": 5.5
}

Example Response (200 OK)

{
  "D1": {
    "vargaName": "राशि (D1)",
    "vargaNum": 1,
    "planets": {
      "Ascendant": { "name": "लग्न", "rashiNum": 9, "rashiName": "धनु", "rashiLord": "गुरु" },
      "Sun": { "name": "सूर्य", "rashiNum": 9, "rashiName": "धनु", "rashiLord": "गुरु" },
      ...
    }
  },
  "D9": {
    "vargaName": "नवांश (D9)",
    "vargaNum": 9,
    "planets": {
      "Ascendant": { "name": "लग्न", "rashiNum": 1, "rashiName": "मेष", "rashiLord": "मंगल" },
      "Sun": { "name": "सूर्य", "rashiNum": 4, "rashiName": "कर्क", "rashiLord": "चंद्र" },
      ...
    }
  },
  ...
}
            

POST /api/ephemeris

Provides detailed astronomical positions, distances, speeds, and retrograde (vakri) status for all major celestial bodies.

Request Parameters: Same as /api/astro

Code Examples

{
  "year": 1990,
  "month": 1,
  "day": 1,
  "hour": 12,
  "minute": 0,
  "latitude": 28.6139,
  "longitude": 77.2090,
  "timezoneOffset": 5.5
}

Example Response (200 OK)

{
  "status": "success",
  "data": {
    "sun": {
      "name": "सूर्य",
      "rightAscension": 18.71,
      "declination": -23.01,
      "eclipticLongitude": 280.72,
      "eclipticLatitude": 0.0003,
      "distanceAU": 0.983,
      "dailySpeedDegrees": 1.019,
      "isRetrograde": false,
      "motionType": "मार्गी (Direct)"
    },
    ...
  }
}
            

POST /api/dasha/ashtottari

Calculates the 108-year Ashtottari Dasha system using the 28 Nakshatra scheme. Returns up to 5 levels of Dasha chains based on targetDate.

Request Parameters: Same as /api/dasha

Code Examples

{
  "year": 1990,
  "month": 1,
  "day": 1,
  "hour": 12,
  "minute": 0,
  "latitude": 28.6139,
  "longitude": 77.2090,
  "timezoneOffset": 5.5
}

Example Response (200 OK)

{
  "status": "success",
  "data": {
    "dashaSystem": "Ashtottari Dasha (108 Years)",
    "moonNirayana": 306.11,
    "startingNakshatra28": 24,
    "dashas": [
      {
        "lord": "गुरु",
        "start": "1990-01-01T05:00:00.000Z",
        "end": "2009-01-01T05:00:00.000Z",
        "isActive": false
      }
      // ... more active dashas
    ]
  }
}
            

POST /api/chart/svg

Generates High-Definition SVG charts in North Indian or South Indian format for any Varga.

Additional Parameters

style: "north" or "south" (Defaults to "north")

varga: "D1", "D9", "D10", etc. (Defaults to "D1")

Response

Returns: Content-Type: image/svg+xml

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 600 600" ...>
   <style>...</style>
   <rect width="600" height="600" class="bg" />
   <text x="300" y="260" class="text-planet">सूर्य</text>
   ...
</svg>
            

POST /api/lalkitab

Calculates the Lal Kitab Kundli where Lagna is always considered Aries (1st house) and planets are placed in their respective birth houses relative to the natal Lagna.

Request Parameters: Same as /api/astro

Code Examples

{
  "year": 1990,
  "month": 1,
  "day": 1,
  "hour": 12,
  "minute": 0,
  "latitude": 28.6139,
  "longitude": 77.2090,
  "timezoneOffset": 5.5
}
                

curl -X POST https://astrology.navasanganakah.com/api/lalkitab \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
  "year": 1990,
  "month": 1,
  "day": 1,
  "hour": 12,
  "minute": 0,
  "latitude": 28.6139,
  "longitude": 77.2090,
  "timezoneOffset": 5.5
}'
                

import requests

url = "https://astrology.navasanganakah.com/api/lalkitab"
headers = {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_API_KEY"
}
data = {
    "year": 1990, "month": 1, "day": 1,
    "hour": 12, "minute": 0,
    "latitude": 28.6139, "longitude": 77.2090,
    "timezoneOffset": 5.5
}

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

<?php
$ch = curl_init("https://astrology.navasanganakah.com/api/lalkitab");
$payload = json_encode([
    "year" => 1990, "month" => 1, "day" => 1,
    "hour" => 12, "minute" => 0,
    "latitude" => 28.6139, "longitude" => 77.2090,
    "timezoneOffset" => 5.5
]);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "x-api-key: YOUR_API_KEY"
]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);

$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
                

fetch("https://astrology.navasanganakah.com/api/lalkitab", {
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        "x-api-key": "YOUR_API_KEY"
    },
    body: JSON.stringify({
        year: 1990, month: 1, day: 1,
        hour: 12, minute: 0,
        latitude: 28.6139, longitude: 77.2090,
        timezoneOffset: 5.5
    })
})
.then(response => response.json())
.then(data => console.log(data));
                

// app/api/fetchLalKitab/route.ts
import { NextResponse } from 'next/server';

export async function POST(request: Request) {
    const body = await request.json();
    const res = await fetch("https://astrology.navasanganakah.com/api/lalkitab", {
        method: "POST",
        headers: {
            "Content-Type": "application/json",
            "x-api-key": process.env.ASTRO_API_KEY!
        },
        body: JSON.stringify(body)
    });
    const data = await res.json();
    return NextResponse.json(data);
}
                

Example Response (200 OK)

{
  "status": "success",
  "data": {
    "lagna": { "house": 1, "rashi": 1 },
    "planets": {
      "sun": {
        "name": "सूर्य",
        "house": 6,
        "rashi": 6
      }
      // ... other planets
    }
  }
}
            

POST /api/numerology

Calculates key numerological values including Radical Number (Moolank), Destiny Number (Bhagyank), and Name Number (Namank) using Chaldean numerology.

Request Parameters: Same as /api/astro, plus an optional name string.

Code Examples

{
  "year": 1990,
  "month": 1,
  "day": 15,
  "name": "Jane Doe"
}
                

curl -X POST https://astrology.navasanganakah.com/api/numerology \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
  "year": 1990,
  "month": 1,
  "day": 15,
  "name": "Jane Doe"
}'
                

import requests

url = "https://astrology.navasanganakah.com/api/numerology"
headers = {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_API_KEY"
}
data = {
    "year": 1990, "month": 1, "day": 15,
    "name": "Jane Doe"
}

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

<?php
$ch = curl_init("https://astrology.navasanganakah.com/api/numerology");
$payload = json_encode([
    "year" => 1990, "month" => 1, "day" => 15,
    "name" => "Jane Doe"
]);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "x-api-key: YOUR_API_KEY"
]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);

$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
                

fetch("https://astrology.navasanganakah.com/api/numerology", {
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        "x-api-key": "YOUR_API_KEY"
    },
    body: JSON.stringify({
        year: 1990, month: 1, day: 15,
        name: "Jane Doe"
    })
})
.then(response => response.json())
.then(data => console.log(data));
                

// app/api/fetchNumerology/route.ts
import { NextResponse } from 'next/server';

export async function POST(request: Request) {
    const body = await request.json();
    const res = await fetch("https://astrology.navasanganakah.com/api/numerology", {
        method: "POST",
        headers: {
            "Content-Type": "application/json",
            "x-api-key": process.env.ASTRO_API_KEY!
        },
        body: JSON.stringify(body)
    });
    const data = await res.json();
    return NextResponse.json(data);
}
                

Example Response (200 OK)

{
  "status": "success",
  "data": {
    "radicalNumber": 6,
    "destinyNumber": 8,
    "nameNumber": 2,
    "details": {
      "moolank": 6,
      "bhagyank": 8,
      "namank": 2
    }
  }
}
            

POST /api/transit/nakshatra

Finds the exact IST time (down to the second) when a specified planet enters a target Nakshatra. Uses dynamic Topocentric elevation for exact precision.

Parameters: planet (String: sun, moon, mars, mercury, jupiter, venus, saturn), nakshatraIndex (Integer: 0 to 26), startYear, startMonth, startDay (IST time), lat, lon.

Code Examples

{
  "planet": "moon",
  "nakshatraIndex": 3,
  "startYear": 2024,
  "startMonth": 5,
  "startDay": 1,
  "lat": 28.6139,
  "lon": 77.2090
}
                        

curl -X POST https://astrology.navasanganakah.com/api/transit/nakshatra \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{ "planet": "moon", "nakshatraIndex": 3, "startYear": 2024, "startMonth": 5, "startDay": 1, "lat": 28.6139, "lon": 77.2090 }'
                        

Example Response (200 OK)

{
  "status": "success",
  "data": {
    "planet": "moon",
    "nakshatraName": "Rohini",
    "targetDegree": 40,
    "actualLongitude": 40.0000001,
    "observer": {
      "lat": 28.6139,
      "lon": 77.209,
      "elevation": 218
    },
    "timestampUTC": "2024-05-09T06:21:10.000Z",
    "timestampIST": "09/05/2024, 11:51:10 am"
  }
}
            

POST /api/weather/saptnadi

Sapt Nadi Chakra Microservice: Calculates the exact Sidereal Longitudes for all 9 planets using the 28 Nakshatra system (including Abhijit). Maps each planet to the 7 Nadis (Chanda, Vata, Bhairavi, Somya, Neera, Jala, Amrita) and implements the "Nadi Lord" amplification rule. Returns fluent Hindi effects based on whether the planet occupies its own Nadi.

Parameters: dateIST (String: exactly "DD/MM/YYYY, HH:MM:SS AM/PM").

Code Examples

{
  "dateIST": "25/06/2026, 12:00:00 PM"
}
                        

curl -X POST https://astrology.navasanganakah.com/api/weather/saptnadi \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{ "dateIST": "25/06/2026, 12:00:00 PM" }'
                        

Example Response (200 OK)

{
  "status": "success",
  "data": {
    "dateIST": "25/06/2026, 12:00:00 PM",
    "planets": [
      {
        "planet": "Moon (चन्द्रमा)",
        "longitude": 125.5,
        "nakshatra": "Magha (मघा)",
        "nadi": "Amrita (अमृत)",
        "isLordInOwnNadi": true,
        "effect": "अमृत नाड़ी का स्वामी चन्द्रमा अपनी ही नाड़ी में स्थित है। यह 'स्वग्रही' प्रभाव उत्पन्न कर रहा है, जिसके फलस्वरूप अत्यंत भारी वर्षा और जलभराव की प्रबल संभावना है।"
      }
    ]
  }
}
            

POST /api/matchmaking/synastry

Advanced Matchmaking Engine: Goes beyond 36-point Ashtakoot by implementing Deep Synastry (Superimposition) and Navamsha (D9) matching. Calculates Sidereal Lagna, identifies the 7th Lord, and checks the exact house placements of each partner's 7th Lord in the other's Kundali.

Parameters: boyProfile and girlProfile objects containing dateIST (String: "DD/MM/YYYY, HH:MM:SS AM/PM"), lat (Float), and lon (Float).

Code Examples

{
  "boyProfile": {
    "dateIST": "15/05/1990, 10:30:00 AM",
    "lat": 28.6139,
    "lon": 77.2090
  },
  "girlProfile": {
    "dateIST": "20/08/1992, 04:45:00 PM",
    "lat": 19.0760,
    "lon": 72.8777
  }
}
                        

curl -X POST https://astrology.navasanganakah.com/api/matchmaking/synastry \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
  "boyProfile": { "dateIST": "15/05/1990, 10:30:00 AM", "lat": 28.6139, "lon": 77.2090 },
  "girlProfile": { "dateIST": "20/08/1992, 04:45:00 PM", "lat": 19.0760, "lon": 72.8777 }
}'
                        

Example Response (200 OK)

{
  "status": "success",
  "data": {
    "advancedCompatibilityScore": 65,
    "specialYogas": [
      "Boy's Saptamesh (saturn) is in Girl's 10th House (Auspicious).",
      "Girl's Saptamesh (moon) is in Boy's 11th House (Auspicious)."
    ],
    "boyDetails": {
      "lagnaRashi": "Cancer",
      "lagnaNavamsha": "Scorpio",
      "saptameshLord": "saturn",
      "saptameshRashi": "Capricorn",
      "saptameshNavamsha": "Taurus",
      "venusNavamsha": "Pisces"
    },
    "girlDetails": {
      "lagnaRashi": "Capricorn",
      "lagnaNavamsha": "Aries",
      "saptameshLord": "moon",
      "saptameshRashi": "Taurus",
      "saptameshNavamsha": "Virgo",
      "venusNavamsha": "Leo"
    },
    "synastryMapping": {
      "boyLordInGirlChartHouse": 10,
      "girlLordInBoyChartHouse": 11
    }
  }
}
            

POST /api/bnn/career-marriage

Bhrigu Nandi Nadi (BNN) Career & Marriage Engine: Determines Career trajectory via Saturn's (Karma Karaka) trines and conjunctions. Determines Marriage outcomes and partner characteristics via Venus (for males) or Mars (for females) and their respective trines/conjunctions.

Parameters: dateString (String) and gender (String: 'male' or 'female').

Code Examples

{
  "dateString": "1990-01-01",
  "gender": "male"
}
                        

curl -X POST https://astrology.navasanganakah.com/api/bnn/career-marriage \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{ "dateString": "1990-01-01", "gender": "male" }'
                        

Example Response (200 OK)

{
  "status": "success",
  "data": {
    "career": {
      "karaka": "शनि (Saturn)",
      "impactingPlanets": [
        {
          "planet": "सूर्य (Sun)",
          "relationship": "युति (Conjunction)",
          "effect": "सरकारी नौकरी या उच्च पद पर आसीन होने की प्रबल संभावना"
        }
      ],
      "prediction": "कर्म कारक शनि गोचर और युति के आधार पर: आपके कर्म भाव पर सूर्य (Sun) का प्रभाव है। परिणामस्वरूप: सरकारी नौकरी या उच्च पद पर आसीन होने की प्रबल संभावना।"
    },
    "marriage": {
      "karaka": "शुक्र (Venus)",
      "impactingPlanets": [
        {
          "planet": "चंद्र (Moon)",
          "relationship": "युति (Conjunction)",
          "effect": "जीवनसाथी भावुक, संवेदनशील और सुंदर होगा"
        },
        {
          "planet": "बुध (Mercury)",
          "relationship": "युति (Conjunction)",
          "effect": "जीवनसाथी युवा, हंसमुख और बुद्धिमान होगा"
        },
        {
          "planet": "राहु (Rahu)",
          "relationship": "युति (Conjunction)",
          "effect": "विवाह में गैर-पारंपरिक या अलग पृष्ठभूमि से जुड़ाव हो सकता है"
        }
      ],
      "prediction": "विवाह कारक शुक्र गोचर और युति के आधार पर: विवाह भाव पर चंद्र (Moon), बुध (Mercury), राहु (Rahu) का प्रभाव है। परिणामस्वरूप: जीवनसाथी भावुक, संवेदनशील और सुंदर होगा तथा जीवनसाथी युवा, हंसमुख और बुद्धिमान होगा तथा विवाह में गैर-पारंपरिक या अलग पृष्ठभूमि से जुड़ाव हो सकता है।"
    }
  }
}