Astrology

Calculate yoga combinations

Detects classical Vedic yogas in a natal chart, such as Pancha Mahapurusha, Raja, Gajakesari and Neecha Bhanga Raja Yoga. Others include Budhaditya, Chandra Mangala, Viparita Raja, Amala, and more. House lords are taken by whole sign from the lagna (so they are found at polar latitudes too) and aspects are full Parashari graha drishti only. Each detected yoga returns formation conditions, the classical texts it is drawn from, a modern summary, and keywords. When no birth time is given, yogas that depend on the lagna are marked needs_birth_time.

post/v1/astro/yoga

Request

  • Base URL: https://api.asterwise.com
  • URL: https://api.asterwise.com/v1/astro/yoga
  • Auth: HTTP bearer

Request body

locationstring nullable

City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.

namestring

Person name associated with the birth record

datestring required

Birth date in YYYY-MM-DD format

timestring nullable

Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.

latitudenumber nullable

Latitude. Required if location not provided.

longitudenumber nullable

Longitude. Required if location not provided.

timezonestring nullable

IANA timezone. Required if location not provided (unless utc_offset is given). For dates before the zone adopted a standard time, the birthplace's local mean time (longitude / 15 hours) is used.

utc_offsetstring nullable

Optional explicit UTC offset of the birth time, as ±HH:MM or ±HH:MM:SS (e.g. '+04:51:31' for Bombay mean time). Overrides the offset timezone would give. Use it when the birth record states the offset, or for historical local times the IANA database cannot represent.

ayanamsa'lahiri' | 'raman' | 'kp' | 'tropical'

Sidereal ayanamsa mode used in calculations

Example request

{
  "ayanamsa": "lahiri",
  "date": "1985-11-12",
  "latitude": 19.055,
  "location": "Mumbai",
  "longitude": 72.8692,
  "name": "Arjun Mehta",
  "time": "06:45",
  "timezone": "Asia/Kolkata"
}

Response

List of detected yoga combinations

successboolean

True if the request succeeded

messagestring

Human-readable status message

Example response

{
  "data": {
    "yogas": [
      {
        "yoga_name": "Gajakesari Yoga",
        "category": "raja_yogas",
        "formation": "Jupiter in Kendra from Moon",
        "modern_summary": "Strong leadership yoga",
        "keywords": [
          "leadership"
        ],
        "classical_sources": [
          {
            "text": "Brihat Parashara Hora Shastra",
            "section": "Chandra yogas"
          }
        ]
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.