Back to Docs

Yoga Detection

POST/api/v1/vedic/yogas

Detect planetary combinations (Yogas) that indicate specific life patterns, talents, and challenges. Includes both auspicious yogas (Raj Yoga, Gajakesari) and challenging combinations (Manglik Dosha, Kala Sarpa).

Full URL

https://astro-api-1qnc.onrender.com/api/v1/vedic/yogas

Detected Yoga Categories

Wealth Yogas

Gajakesari, Dhana Yoga, Lakshmi Yoga

Raj Yogas

Power, authority, and leadership combinations

Afflictions

Manglik Dosha, Kala Sarpa, Sade Sati

Intelligence

Budha-Aditya, Saraswati Yoga

Request Parameters

ParameterTypeRequiredDescription
yearintegerYesYear of birth (e.g., 1990)
monthintegerYesMonth of birth (1-12)
dayintegerYesDay of birth (1-31)
hourintegerYesHour of birth (0-23)
minuteintegerYesMinute of birth (0-59)
latfloatYesLatitude of birth location (-90 to 90)
lngfloatYesLongitude of birth location (-180 to 180)
citystringNoCity name (for display purposes)
tz_strstringNoTimezone string (e.g., 'Asia/Kolkata'). Use 'AUTO' for automatic detection.
ayanamshastringNoAyanamsha system: 'lahiri' (default), 'raman', 'krishnamurti'
house_systemstringNoHouse system: 'whole_sign' (default), 'placidus', 'equal'
node_typestringNoLunar node type: 'mean' (default) or 'true'

Sample Code

import requests
import json

url = "https://astro-api-1qnc.onrender.com/api/v1/vedic/yogas"

payload = {
    "year": 1990,
    "month": 5,
    "day": 15,
    "hour": 10,
    "minute": 30,
    "city": "New Delhi",
    "lat": 28.6139,
    "lng": 77.2090,
    "tz_str": "Asia/Kolkata",
    "ayanamsha": "lahiri",
    "house_system": "whole_sign",
    "node_type": "mean"
}

headers = {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_API_KEY"
}

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

Response Data

{
  "yogas": [
    {
      "name": "Gajakesari Yoga",
      "category": "Wealth & Success",
      "active": true,
      "planets": ["Moon", "Jupiter"],
      "description": "Moon and Jupiter in mutual kendras. Bestows wisdom, fame, and leadership qualities.",
      "strength": "Strong"
    },
    {
      "name": "Budha-Aditya Yoga",
      "category": "Intelligence",
      "active": true,
      "planets": ["Sun", "Mercury"],
      "description": "Sun and Mercury conjunct. Grants sharp intellect and communication skills.",
      "strength": "Medium"
    },
    {
      "name": "Manglik Dosha",
      "category": "Affliction",
      "active": false,
      "planets": ["Mars"],
      "description": "Mars in 1st, 4th, 7th, 8th, or 12th house. Affects marriage compatibility.",
      "strength": null
    },
    {
      "name": "Kala Sarpa Yoga",
      "category": "Affliction",
      "active": false,
      "planets": ["Rahu", "Ketu"],
      "description": "All planets between Rahu and Ketu. Creates karmic challenges.",
      "strength": null
    },
    {
      "name": "Raj Yoga",
      "category": "Power & Authority",
      "active": true,
      "planets": ["Venus", "Saturn"],
      "description": "Lords of Kendra and Trikona houses conjoined. Grants status and authority.",
      "strength": "Strong",
      "houses_involved": [1, 9]
    },
    {
      "name": "Dhana Yoga",
      "category": "Wealth",
      "active": true,
      "planets": ["Jupiter", "Venus"],
      "description": "Lords of 2nd and 11th houses in conjunction or mutual aspect.",
      "strength": "Medium"
    }
    // ... more yogas
  ],
  "summary": {
    "total_detected": 6,
    "active": 4,
    "inactive": 2,
    "by_category": {
      "Wealth & Success": 2,
      "Intelligence": 1,
      "Power & Authority": 1,
      "Affliction": 2
    }
  },
  "metadata": {
    "ayanamsha": "lahiri",
    "house_system": "whole_sign"
  }
}

Related Endpoints