API Documentation

NavaSanganakah Multiventures

Introduction

Welcome to the Yagya Mitra Astrology API documentation. Provided by NavaSanganakah Multiventures and Yagya Ashram, these APIs offer precise astronomical calculations for both Vedic (Sidereal) and Western (Tropical) astrological systems. Our endpoints are designed to be fast, reliable, and easy to integrate into your spiritual or astrological applications.

Jyotish Master API

The master endpoint for commercial-grade astrology. Supports both Sidereal (Nirayana) and Tropical (Sayana) systems with high-precision calculations.

Endpoint

GET/api/jyotish

Query Parameters

ParameterTypeRequiredDescription
datestringNoISO Date string. Defaults to current time.
latnumberNoLatitude. Defaults to 28.6139.
lngnumberNoLongitude. Defaults to 77.2090.
siderealbooleanNoSet to true for Vedic/Sidereal system. Defaults to false.

API Explorer

{
  "success": true,
  "timestamp": "2026-03-22T04:00:00.000Z",
  "data": {
    "moonPhase": { "phase": 14.5, "name": "Waxing Crescent", "hindiName": "शुक्ल पक्ष" },
    "planets": [ { "name": "Sun", "longitude": 335.2, "sign": "Pisces" } ]
  },
  "meta": { "service": "Jyotish API (Commercial Grade)" }
}

Vedic Astrology API

Provides planetary positions and moon phases based on the Sidereal Zodiac (Nirayana) using Lahiri Ayanamsa. Ideal for Jyotish and Indian astrological calculations.

Endpoint

GET/api/vedic

Query Parameters

ParameterTypeRequiredDescription
datestringNoISO Date string (e.g., 2026-03-21). Defaults to current time.
latnumberNoLatitude (e.g., 28.6139). Defaults to New Delhi.
lngnumberNoLongitude (e.g., 77.2090). Defaults to New Delhi.

API Explorer

{
  "success": true,
  "system": "Vedic (Sidereal)",
  "timestamp": "2026-03-22T04:00:00.000Z",
  "data": {
    "moonPhase": {
      "phase": 14.5,
      "name": "Waxing Crescent",
      "hindiName": "शुक्ल पक्ष"
    },
    "planets": [
      {
        "name": "Sun",
        "hindiName": "सूर्य",
        "longitude": 335.2,
        "sign": "Pisces",
        "hindiSign": "मीन",
        "house": 0
      }
      // ... other planets
    ]
  },
  "meta": {
    "provider": "NavaSanganakah Multiventures",
    "branch": "Yagya Ashram",
    "guide": "Yagya Mitra",
    "service": "Vedic Jyotish API"
  }
}

Western Astrology API

Provides planetary positions based on the Tropical Zodiac (Sayana) without Ayanamsa. Ideal for Western astrological calculations.

Endpoint

GET/api/western

Query Parameters

ParameterTypeRequiredDescription
datestringNoISO Date string (e.g., 2026-03-21). Defaults to current time.
latnumberNoLatitude (e.g., 28.6139). Defaults to New Delhi.
lngnumberNoLongitude (e.g., 77.2090). Defaults to New Delhi.

API Explorer

{
  "success": true,
  "system": "Western (Tropical)",
  "timestamp": "2026-03-22T04:00:00.000Z",
  "data": {
    "moonPhase": {
      "phase": 14.5,
      "name": "Waxing Crescent",
      "hindiName": "शुक्ल पक्ष"
    },
    "planets": [
      {
        "name": "Sun",
        "hindiName": "सूर्य",
        "longitude": 359.1,
        "sign": "Pisces",
        "hindiSign": "मीन",
        "house": 0
      }
      // ... other planets
    ]
  },
  "meta": {
    "provider": "NavaSanganakah Multiventures",
    "branch": "Yagya Ashram",
    "guide": "Yagya Mitra",
    "service": "Western Astrology API"
  }
}

Astronomy Engine API

Direct access to raw astronomical data including Right Ascension, Declination, Constellations, Eclipses, and Seasons using the core astronomy-engine.

Endpoint

GET/api/astronomy

Query Parameters

ParameterTypeRequiredDescription
datestringNoISO Date string. Defaults to current time.
latnumberNoObserver Latitude.
lngnumberNoObserver Longitude.
elevationnumberNoObserver Elevation in meters. Defaults to 0.

API Explorer

{
  "success": true,
  "timestamp": "2026-03-22T04:00:00.000Z",
  "observer": { "lat": 28.6139, "lng": 77.209, "elevation": 0 },
  "data": {
    "positions": [
      {
        "body": "Sun",
        "rightAscension": 0.05,
        "declination": 0.02,
        "distance": 0.996,
        "constellation": "Pisces"
      }
    ],
    "events": {
      "nextMoonQuarter": { "quarter": 1, "time": "2026-03-26T..." },
      "nextLunarEclipse": { "kind": "Partial", "peakTime": "..." },
      "nextSolarEclipse": { "kind": "Annular", "peakTime": "..." }
    },
    "seasons": {
      "marchEquinox": "2026-03-20T...",
      "juneSolstice": "2026-06-21T..."
    }
  },
  "meta": { "engine": "astronomy-engine" }
}