POST · VEDIC

Manglik Report

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

Combines computed Mangal Dosha analysis from three reference points (Lagna, Moon, Venus) with pre-written multilingual interpretation, severity guide, house-specific text, and remedies. Detects double Manglik, cancellation rules, and severity levels.

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, −90…90.
longitudenumberYesDecimal degrees, −180…180.
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.
include_second_housebooleanNoDefault false. Include 2nd house in dosha check (some traditions include it).

Response shape

mars_position

FieldTypeDescription
houseintegerMars house from lagna.
signstringSign name.
degreenumberDegree in sign.
longitudenumberAbsolute longitude.
retrogradebooleanRetrograde status.

manglik object

FieldTypeDescription
has_manglikbooleanPrimary Manglik status (from lagna).
severitystringnone, mild, moderate, severe.
is_double_manglikbooleanMars + another malefic in dosha houses.
double_manglik_reasonstringExplanation when double Manglik.
from_lagnaobjectAnalysis from Ascendant: in_dosha_house, house, reference, note.
from_moonobjectAnalysis from Moon (secondary reference).
from_venusobjectAnalysis from Venus (secondary reference).
effectsarrayEffect descriptions when Manglik is present.
summarystringPlain-English summary of the analysis.

Interpretation blocks

Four interpretation blocks are returned, each with title, text, keywords:

FieldContent
interpretationStatus text: not present, present from lagna, present from both, or cancelled.
house_interpretationMars-in-house-specific text (e.g. Mars in 7th, Mars in 8th). null when not Manglik.
severity_guideGeneral severity ranking guide (always returned).
remedyManglik remedies (always returned).

Errors

HTTPCodeCause
400MISSING_FIELDRequired field absent.
400INVALID_DATEYear out of range or bad calendar date.
400INVALID_TIMEHour or minute 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

  • Dosha houses are 1, 4, 7, 8, 12 (add 2nd house with include_second_house: true).
  • Three reference points are always computed: Lagna (primary), Moon, and Venus.
  • Cancellation rules are applied automatically (e.g. Jupiter aspect, Mars in own sign).
  • house_interpretation is null when Mars is not in a dosha house from lagna.

See also