POST · VEDIC

Grahan Status

Endpoint POST https://starsapi.com/api/v3/vedic/yogas-doshas/grahan-status

Returns a quick Grahan Dosha check — whether either luminary (Sun or Moon) is afflicted by Rahu or Ketu, with severity and a one-line summary.

Authentication

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

Request body

FieldTypeRequiredDescription
namestringNoEchoed in the response.
genderstringNomale or female — used by gender-specific yoga rules.
yearintegerYesBirth year.
monthintegerYesBirth month, 1–12.
dayintegerYesDay of month.
hourintegerYesHour, 24-hour.
minuteintegerYesMinute.
secondintegerNoDefault 0.
latitudenumberYesDecimal degrees.
longitudenumberYesDecimal degrees.
timezonestringYesIANA timezone.
ayanamsastringNoDefault lahiri.
node_typestringNomean (default) or true.

Response shape

FieldTypeDescription
system / doshastringSystem and dosha labels.
presentbooleanWhether Grahan Dosha exists.
severitystringGraded by orb tightness.
surya_grahan / chandra_grahanbooleanSun-side and Moon-side flags.
countintegerNumber of grahan combinations.
summarystringOne-line verdict.

Errors

HTTPCodeCause
400MISSING_FIELDRequired field absent.
400INVALID_DATEBad calendar date.
400INVALID_TIMEHour/minute/second out of range.
400INVALID_TIMEZONENon-IANA timezone.
400INVALID_COORDINATELat/lon out of range.
400INVALID_PARAMBad ayanamsa or node_type.
405METHOD_NOT_ALLOWEDNon-POST request.

See also