Yogas and doshas

Yoga (in a chart) in Vedic astrology

In a birth chart, a yoga is a named combination of planets that tradition links to a result, such as wealth, fame or hardship. Gajakesari yoga, for example, needs Jupiter in a kendra from the Moon. The API reports each yoga it finds, and each one it checked but did not find, with the rule it tested. It is not the same as the panchang yoga.

Updated Nov 3, 2026

More terms in Yogas and doshas

Yoga: how the API computes it

POST /v1/yogas tests a chart against every yoga the API knows, and returns two lists. The formed list holds the yogas that are present. The not_formed list holds the ones it checked and did not find. So you can show why a famous yoga is missing instead of leaving a gap.

Each item names the yoga and the rule that was tested, with the planets and houses involved. Gajakesari yoga, for example, needs Jupiter in a kendra from the Moon. That means the Moon's own sign or the 4th, 7th or 10th sign from it.

The response says whether that was true for this chart. The API checks 104 yogas. They range from the five Pancha Mahapurusha yogas to wealth, hardship and Nabhasa yogas. It does not guess a strength or a life result for you. It reports whether the classical condition is met.

Your product decides how much to say about it. A yoga in this sense is not the same as the panchang yoga, one of the five parts of the day. The glossary entry for the panchang yoga covers that one.

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/yogas	Yogas: planetary combinations found and not found
POST	/v1/summary	Plain-language summary of a chart
POST	/v1/varshaphal	The Tajik annual chart (varshaphal) for one year
POST	/v1/reading/section/{section_id}	One section of a reading
POST	/v1/reading/daily	Daily reading for a chart
POST	/v1/spiritual	Spiritual path reading: devotion and release

What the API reference says

Each line is quoted from the reference page of the endpoint named above it.

POST /v1/yogas · Yogas: planetary combinations found and not foundReturns every yoga this API checks for, split into formed and not_formed.
POST /v1/varshaphal · The Tajik annual chart (varshaphal) for one yeartajaka_yogas lists the Tajik yogas (planet pairings) the year forms.

Yogas the API checks

Ruchaka
Bhadra
Hamsa
Malavya
Sasa
Harsha
Sarala
Vimala
Budhaditya
Chandra-Mangala
Guru-Mangala
Gajakesari
Dharma-Karmadhipati
Dharma-Karmadhipati (partial)
Kemadruma
Neecha Bhanga
Neecha Bhanga Raja
Maha Parivartana
Khala Yoga
Dainya Yoga
Sunapha
Anapha
Durudhara
Vesi
Vasi
Ubhayachari
Vasumathi
Adhi
Parvata
Saraswati
Daridra
Aputra
Raja
Grahan
Pravrajya
Rajju
Musala
Nala
Mala
Sarpa
Gada
Sakata
Vihaga
Shringataka
Hala
Vajra
Yava
Kamala
Vapi
Yupa
Shara
Shakti
Danda
Nauka
Kuta
Chhatra
Chapa
Ardha Chandra
Chakra
Samudra
Vallaki
Dama
Pasha
Kedara
Shula
Yuga
Gola
Dhana (5th house)
Dhana (lagna)
Bhratrumoola Dhanaprapti
Putramooladhana
Satrumooladhana
Kalatramooladhana
Ayatnadhanalabha
Daridra (1st and 6th exchange)
Daridra (5th and 9th lords)
Daridra (Mars and Saturn in the 2nd)
Daridra (Sun in the 2nd)
Ekaputra
Satputra
Kalanirdesat Putra
Kalanirdesat Putranasa
Theevrabuddhi
Sodaranasa
Satkalatra
Jara
Bharyasahavyabhicharya
Mooka
Nishturabhashi
Kushtaroga
Bandhana
Adhama
Sama
Varishtha
Kahala
Chamara
Shankha
Maharaja
Kalanidhi
Rahu-Ketu Raja
Papa Kartari
Shubha Kartari
Papa Kartari (Moon)
Shubha Kartari (Moon)

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.

Get a free API key Open the API reference

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.

01
Test key: 1,000 test calls a month to build with
02
Free plan: 2,000 live calls a month, no card needed
03
Open rules: every rule is published, so you can check any answer