POST · VEDIC

Mangal Dosha

Endpoint POST https://starsapi.com/api/v3/vedic/matchmaking/mangal-dosha

Returns Manglik (Mangal Dosha) analysis for both persons — checks Mars position from Ascendant, Moon, and Venus. Includes severity, active positions, cancellation rules, and paired compatibility verdict.

Works with both Ashtakoot and Porutham systems. All matchmaking endpoints use the same person1 / person2 request format.

Authentication

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

Request body

FieldTypeRequiredDescription
person1objectYesFirst person’s birth data (see fields below).
person2objectYesSecond person’s birth data (same fields).
Each person object:
yearintegerYesBirth year.
monthintegerYesBirth month, 1–12.
dayintegerYesDay of month.
hourintegerYesHour, 24-hour.
minuteintegerYesMinute.
secondintegerNoDefault 0.
latitudenumberYesDecimal degrees.
longitudenumberYesDecimal degrees.
timezonestringYesIANA timezone.
Optional (top-level):
ayanamsastringNoDefault lahiri.
node_typestringNomean (default) or true.

Response shape

person1 / person2

FieldTypeDescription
is_manglikbooleanOverall Manglik status.
severitystringmild, moderate, or severe.
active_positionsintegerNumber of references (ASC/Moon/Venus) where Mars is in a dosha house.
marsobjectMars sign, longitude, retrograde status.
from_ascendantobjectis_manglik and house from ASC.
from_moonobjectis_manglik and house from Moon.
from_venusobjectis_manglik and house from Venus.
cancellationsarrayApplicable cancellation rules (e.g. Jupiter aspect).

paired

FieldTypeDescription
compatiblebooleanWhether the pair is Manglik-compatible.
verdictstringmutually_cancelled, one_sided, both_clear, etc.
reasonstringExplanation.

Errors

HTTPCodeCause
400MISSING_FIELDRequired field absent.
400INVALID_DATEBad calendar date.
400INVALID_TIMEZONENon-IANA timezone.
400INVALID_COORDINATELat/lon out of range.
405METHOD_NOT_ALLOWEDNon-POST request.

See also