POST/v1/astro/yoga

Calculate yoga combinations

Detect all classical Vedic yogas in a natal chart — Pancha Mahapurusha Yogas, Raja Yogas, Gajakesari, Neecha Bhanga Raja Yoga, Budhaditya, Chandra Mangala, and more. Each detected yoga returns formation conditions, the classical texts it is drawn from, a modern summary, and keywords.

Request parameters

locationoptional

string | null

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

nameoptional

string

Person name associated with the birth record

daterequired

string

Birth date in YYYY-MM-DD format

timeoptional

string | null

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

latitudeoptional

number | null

Latitude. Required if location not provided.

longitudeoptional

number | null

Longitude. Required if location not provided.

timezoneoptional

string | null

IANA timezone. Required if location not provided.

ayanamsaoptional

string

Sidereal ayanamsa mode used in calculations

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.yogas

array[object]

data.yogas[].yoga_name

string

Detected yoga name

data.yogas[].category

string

Yoga category bucket

data.yogas[].formation

string

Formation condition

data.yogas[].modern_summary

string

Modern interpretation summary

data.yogas[].keywords

array[string]

Interpretation keywords

data.yogas[].classical_sources

array[object]

Classical texts this yoga is drawn from (empty when the yoga comes from general tradition rather than a named text)

data.yogas[].classical_sources[].text

string

Classical text

data.yogas[].classical_sources[].section

string | null

Section of the text, when unambiguous

data.birth_time_provided

boolean

Whether a precise birth time was provided. False when birth time was not supplied or treated as unknown — calculations using this field will have lagna-dependent accuracy limits.

Errors

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

Reserved; product endpoints are not feature-gated by plan (quota differs by tier).

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

Related endpoints

• Calculate dosha report
• Ghat Chakra
• Pitru Dosha (Pitru Shapa)
• Sade Sati periods

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/astro/yoga" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1985-11-12","time":"06:45","latitude":19.076,"longitude":72.8777,"timezone":"Asia/Kolkata"}'

Python

import asterwise
from asterwise.api.astrology_api import AstrologyApi
from asterwise.models.yoga_request import YogaRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = YogaRequest(
    date="1985-11-12",
    time="06:45",
    latitude=19.076,
    longitude=72.8777,
    timezone="Asia/Kolkata",
)

with asterwise.ApiClient(configuration) as client:
    api = AstrologyApi(client)
    result = api.yogas(yoga_request=request)
    print(result)

TypeScript

import { createClient, createConfig, yogas } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await yogas({
  client,
  body: {
      "date": "1985-11-12",
      "time": "06:45",
      "latitude": 19.076,
      "longitude": 72.8777,
      "timezone": "Asia/Kolkata"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "yogas": [
      {
        "yoga_name": "Neech Bhanga Raja Yoga (Sun)",
        "category": "raja_yogas",
        "formation": "Any of: Lord of debilitation sign or planet exalted in that sign occupies Kendra from Lagna or Moon; Lord of debilitatio…",
        "modern_summary": "Neecha Bhanga Raja Yoga is among the most powerful combinations in Vedic astrology precisely because it transforms weakn…",
        "keywords": [
          "weakness transformed to strength",
          "overcoming massive hurdles",
          "... and 2 more items"
        ],
        "classical_sources": [
          {
            "text": "Phaladeepika",
            "section": "Adhyaya 7"
          }
        ]
      },
      {
        "yoga_name": "Neech Bhanga Raja Yoga (Jupiter)",
        "category": "raja_yogas",
        "formation": "Any of: Lord of debilitation sign or planet exalted in that sign occupies Kendra from Lagna or Moon; Lord of debilitatio…",
        "modern_summary": "Neecha Bhanga Raja Yoga is among the most powerful combinations in Vedic astrology precisely because it transforms weakn…",
        "keywords": [
          "weakness transformed to strength",
          "overcoming massive hurdles",
          "... and 2 more items"
        ],
        "classical_sources": [
          {
            "text": "Phaladeepika",
            "section": "Adhyaya 7"
          }
        ]
      },
      "... and 13 more items"
    ],
    "birth_time_provided": true
  }
}