New Numerology API

Yogas and doshas

Pancha mahapurusha yoga in Vedic astrology

The pancha mahapurusha yogas are five yogas, one for each visible planet other than the Sun and Moon: Ruchaka (Mars), Bhadra (Mercury), Hamsa (Jupiter), Malavya (Venus) and Sasa (Saturn). Each forms when that planet is in its own or exaltation sign and in a kendra.

Updated

More terms in Yogas and doshas

© API for Astrology (apiforastrology.com). "Glossary houses chart". All rights reserved. Not to be copied or reused.123456789101112A strong planet in a kendra

Pancha mahapurusha yoga: how the API computes it

The pancha mahapurusha yogas are five yogas, each made by one planet (YG-01 to YG-05). Ruchaka is made by Mars, Bhadra by Mercury and Hamsa by Jupiter. Malavya is made by Venus and Sasa by Saturn.

The rule is the same for all five. The planet must be in its own sign or its exaltation sign. Its own sign is a sign it rules, and its exaltation sign is where it is strongest. It must also stand in a kendra from the ascendant (rising sign). That means house 1, 4, 7 or 10.

The Sun and the Moon cannot make one. POST /v1/yogas checks all five on every chart. It lists each one in formed or not_formed.

The category shows as pancha mahapurusha, and the response names the planet and the house. The not_formed list is useful, because it tells you which one is missing and why. The five are fairly uncommon, because a planet has to meet two tests at once. So a chart with one is a good thing to put at the top of a reading.

Tradition links each to the qualities of its planet.

Get it from the API

Yogas: planetary combinations found and not found. Here is the call to API for Astrology (apiforastrology.com) for our sample, John Doe, born Aug 15, 1990, 10:30 AM, New York.

POST /v1/yogas

# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/yogas" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'
Answer (long lists shortened)200 OK
{
  "formed": [
    {
      "name": "Sarala",
      "category": "vipareeta raja",
      "rule": "lord of house 8 placed in a dusthana (6,8,12); free of conjunction or aspect from a natural benefic or a kendra/trikona lord (1,4,5,7,9,10), and the lagna lord stronger in shadbala",
      "detail": "Mars in house 8, unafflicted; lagna lord Mercury stronger in shadbala (532.98 vs 526.26 virupas)"
    },
    {
      "name": "Anapha",
      "category": "lunar",
      "rule": "a graha other than the Sun and the nodes in the 12th from the Moon",
      "detail": "Mars"
    },
    {
      "name": "Vesi",
      "category": "solar",
      "rule": "a graha other than the Moon and the nodes in the 2nd from the Sun",
      "detail": "Mercury"
    }
  ],
  "not_formed": [
    {
      "name": "Ruchaka",
      "rule": "Mars in its own or exaltation sign AND in a kendra (1,4,7,10)",
      "reason": "Mars is dignified but house 8 is not a kendra"
    },
    {
      "name": "Hamsa",
      "rule": "Jupiter in its own or exaltation sign AND in a kendra (1,4,7,10)",
      "reason": "Jupiter is dignified but house 11 is not a kendra"
    },
    {
      "name": "Harsha",
      "rule": "lord of house 6 placed in a dusthana (6,8,12); free of conjunction or aspect from a natural benefic or a kendra/trikona lord (1,4,5,7,9,10), and the lagna lord stronger in shadbala",
      "reason": "Saturn is in house 4"
    }
  ],
  "neecha_bhanga": [],
  "meta": {
    "ayanamsa": "lahiri",
    "ayanamsa_value": 23.7260727,
    "julian_day": 2448119.10483,
    "ephemeris": "JPL DE440s",
    "node": "true",
    "timezone": {
      "source": "zone",
      "offset_hours": -4,
      "zone": "America/New_York",
      "abbreviation": "EDT",
      "dst": true,
      "dst_hours": 1,
      "ambiguous_resolved_by_fold": null,
      "note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
    }
  },
  "lagnesh": "Mercury",
  "yogakaraka": null,
  "kartari": {
    "by_house": {
      "1": {
        "sign": "Virgo",
        "state": "none",
        "in_twelfth": [
          "Mercury"
        ],
        "in_second": []
      },
      "2": {
        "sign": "Libra",
        "state": "none",
        "in_twelfth": [],
        "in_second": []
      },
      "3": {
        "sign": "Scorpio",
        "state": "none",
        "in_twelfth": [],
        "in_second": [
          "Saturn"
        ]
      },
      "4": {
        "sign": "Sagittarius",
        "state": "none",
        "in_twelfth": [],
        "in_second": [
          "Rahu"
        ]
      },
      "5": {
        "sign": "Capricorn",
        "state": "none",
        "in_twelfth": [
          "Saturn"
        ],
        "in_second": []
      },
      "6": {
        "sign": "Aquarius",
        "state": "none",
        "in_twelfth": [
          "Rahu"
        ],
        "in_second": []
      },
      "7": {
        "sign": "Pisces",
        "state": "none",
        "in_twelfth": [],
        "in_second": [
          "Mars"
        ]
      },
      "8": {
        "sign": "Aries",
        "state": "none",
        "in_twelfth": [],
        "in_second": [
          "Moon"
        ]
      },
      "9": {
        "sign": "Taurus",
        "state": "none",
        "in_twelfth": [
          "Mars"
        ],
        "in_second": []
      },
      "10": {
        "sign": "Gemini",
        "state": "none",
        "in_twelfth": [
          "Moon"
        ],
        "in_second": [
          "Sun",
          "Jupiter",
          "Venus"
        ]
      },
      "11": {
        "sign": "Cancer",
        "state": "none",
        "in_twelfth": [],
        "in_second": [
          "Mercury"
        ]
      },
      "12": {
        "sign": "Leo",
        "state": "none",
        "in_twelfth": [
          "Sun",
          "Jupiter",
          "Venus"
        ],
        "in_second": []
      }
    },
    "by_graha": {
      "Sun": {
        "state": "none",
        "in_twelfth": [],
        "in_second": [
          "Mercury"
        ]
      },
      "Moon": {
        "state": "none",
        "in_twelfth": [
          "Mars"
        ],
        "in_second": []
      },
      "Mars": {
        "state": "none",
        "in_twelfth": [],
        "in_second": [
          "Moon"
        ]
      },
      "Mercury": {
        "state": "none",
        "in_twelfth": [
          "Sun",
          "Jupiter",
          "Venus"
        ],
        "in_second": []
      },
      "Jupiter": {
        "state": "none",
        "in_twelfth": [],
        "in_second": [
          "Mercury"
        ]
      },
      "Venus": {
        "state": "none",
        "in_twelfth": [],
        "in_second": [
          "Mercury"
        ]
      },
      "Saturn": {
        "state": "none",
        "in_twelfth": [],
        "in_second": [
          "Rahu"
        ]
      },
      "Rahu": {
        "state": "none",
        "in_twelfth": [
          "Saturn"
        ],
        "in_second": []
      },
      "Ketu": {
        "state": "none",
        "in_twelfth": [],
        "in_second": [
          "Mercury"
        ]
      }
    },
    "rule": "Hemmed by occupation only: grahas in both the 12th and the 2nd sign from the house or graha. papa = malefics on both sides and no benefic; shubha = the reverse; none otherwise. The Moon by paksha, Mercury by its company. Aspects never form…"
  }
}

Where the API returns it

POST/v1/yogasYogas: planetary combinations found and not found

Feature page: Yogas and doshas. Who uses it: Astrologer consultation platforms. The classical rules the API follows are in the rulebook.

How we check the numbers

Every value here starts from planet positions worked out from NASA JPL planet data (DE440). We test them against NASA JPL Horizons, NASA's planet position service. On 25,571 positions from 1850 to 2149, the Sun and planets agree within 0.001 arc seconds. The Moon agrees within 0.011. On 2,000 random birth charts, the rising sign agrees with Swiss Ephemeris within 0.004 arc seconds. An arc second is 1/3,600 of a degree. A practicing astrologer reviews the rules behind these answers. See how we test.

Related terms

Astrology API

Get these values from the API

Create a free test key and call any endpoint on this page. Or try a request in the API reference first.

Your first answer

John Doe, New York

POST /v1/planets200 OK
  • RisingVirgoHast
  • SunCancerAshlesha
  • MoonTaurusMrigashira
  • MarsAriesKrittika

Real API output. A free test key gets the same answer.

  1. 01

    Test key: 1,000 test calls a month to build with

  2. 02

    Free plan: 2,000 live calls a month, no card needed

  3. 03

    Open rules: every rule is published, so you can check any answer