POST/v1/astro/yoga

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.

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 (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_offsetoptional

string | null

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.

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

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

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
  }
}