POST · VEDIC

Yogas Report

Endpoint POST https://starsapi.com/api/v3/vedic/predictions/yogas-report

Detects classical Vedic yogas (57 rules checked) and returns each found yoga with computed details (planets, houses, strength) plus pre-written multilingual interpretation text. Covers Pancha Mahapurusha, Chandra yogas, Surya yogas, Dhana yogas, Raja yogas, Viparita Raja, Nabhasa yogas, and dosha yogas.

Authentication

MethodExample
Header (recommended)X-Api-Key: am_live_xxxxxxxxxxxx
BearerAuthorization: Bearer am_live_xxxxxxxxxxxx
Query?api_key=am_live_xxxxxxxxxxxx

Request body

FieldTypeRequiredDescription
yearintegerYesBirth year, 1800–2400.
monthintegerYesBirth month, 1–12.
dayintegerYesDay of month.
hourintegerYesHour, 0–23.
minuteintegerYesMinute, 0–59.
secondintegerNoDefault 0.
latitudenumberYesDecimal degrees.
longitudenumberYesDecimal degrees.
timezonestringYesIANA timezone identifier.
ayanamsastringNoDefault lahiri.
node_typestringNomean (default) or true.
languagestringNoDefault en. Supported: en, es, fr, pt, it, de, ru, hi, ta, te, kn, ml, bn.

Response shape

summary

FieldTypeDescription
total_foundintegerNumber of yogas detected.
total_checkedintegerNumber of yoga rules evaluated.

Yoga object

FieldTypeDescription
idstringUnique yoga identifier, e.g. "malavya", "gajakesari".
namestringDisplay name.
categorystringpancha_mahapurusha, chandra_yoga, surya_yoga, dhana_yoga, special_raja, benefic_yoga, nabhasa_yoga, dosha.
strengthstringstrong, medium, or weak.
planets_involvedarrayPlanets forming the yoga.
houses_involvedarrayHouses involved.
detailsstringFormation details, e.g. "Venus in Pisces in house 7".
descriptionstringEngine-generated description (always present).
interpretationobject | absentPre-written text with title, text, keywords. Present when interpretation data exists for this yoga.

Errors

HTTPCodeCause
400MISSING_FIELDRequired field absent.
400INVALID_DATEYear out of range or bad calendar date.
400INVALID_TIMEHour, minute, or second out of range.
400INVALID_TIMEZONENon-IANA timezone.
400INVALID_COORDINATELatitude or longitude out of range.
400INVALID_PARAMBad node_type, ayanamsa, or language.
405METHOD_NOT_ALLOWEDNon-POST request.
500COMPUTE_ERRORChart computation failed.

Notes

  • interpretation is present only for yogas that have pre-written text. Some yogas return only the engine-generated description.
  • Dosha-category yogas (e.g. Shrapit Dosha, Pitru Dosha) are included alongside benefic yogas — filter by category on the client side.
  • The number of yogas found varies per chart — typically 5–15.

See also