Skip to content

Vedic relationships

Vedic relationship endpoints compare two stored Vedic charts and return deterministic compatibility features. They are separate from the older generic /v1/compatibility endpoint and expose a product-ready Vedic relationship surface.

All endpoints require charts:read.

Request body

{
  "chart_a_id": "chart_a",
  "chart_b_id": "chart_b"
}

The chart ids must be distinct and both charts must be Vedic.

For Ashtakoota scoring, chart_a_id is evaluated in the groom-side role and chart_b_id in the bride-side role. This matters for role-sensitive dimensions such as Varna. If your product does not collect gendered roles, call the endpoint in both directions and present the pair as an ordered traditional score.

Unified report — POST /v1/vedic/relationships/report

Product-ready compatibility report that combines all deterministic Vedic relationship layers in one response:

  • Ashtakoota/Kuta score out of 36.
  • Doshas and cancellation evidence.
  • Relationship overlays for Moon, Venus, Mars, Jupiter, and Lagna.
  • Upapada comparison.
  • Navamsa/D9 comparisons for Moon, Venus, Mars, Jupiter, and Lagna.
  • Topic cards for UI sections.
{
  "chart_a_id": "chart_a",
  "chart_b_id": "chart_b",
  "method_version": "vedic-relationship-report-v1",
  "summary": {
    "score_percent": 72.4,
    "polarity": "mixed",
    "confidence": "high",
    "evidence": [
      "Ashtakoota score 27/36",
      "1 active doshas",
      "Includes Kuta, dosha, overlays, Upapada, and Navamsa layers"
    ]
  },
  "layers": [
    {
      "layer": "ashtakoota",
      "score": 27.0,
      "max_score": 36.0,
      "ratio": 0.75,
      "polarity": "mixed",
      "evidence": ["Ashtakoota score 27/36"]
    }
  ],
  "kuta": {"…": "same shape as /relationships/kuta"},
  "doshas": {"…": "same shape as /relationships/doshas"},
  "highlights": {"…": "same shape as /relationships/highlights"},
  "topics": {"…": "same shape as /relationships/topics"},
  "navamsa": [
    {
      "point": "venus",
      "chart_a_sign": "taurus",
      "chart_b_sign": "libra",
      "distance_a_to_b": 6,
      "distance_b_to_a": 8,
      "polarity": "challenging",
      "evidence": ["D9 distance is 6/8"]
    }
  ],
  "features_used": ["…"]
}

Layer names:

  • ashtakoota
  • dosha_balance
  • relationship_overlays
  • upapada
  • navamsa

The summary score is a weighted product score, not a classical shastra score. The classical score remains kuta.total out of 36.

Kuta breakdown — POST /v1/vedic/relationships/kuta

Detailed Ashtakoota dimensions.

{
  "chart_a_id": "chart_a",
  "chart_b_id": "chart_b",
  "method_version": "vedic-relationship-v1",
  "total": 27,
  "max_total": 36,
  "flags": ["nadi_dosha"],
  "scores": [
    {
      "kuta": "nadi",
      "points": 0,
      "max_points": 8,
      "ratio": 0.0,
      "dosha": true,
      "reason": "Both share adi nadi — Nadi Dosha"
    }
  ],
  "features_used": ["…"]
}

Returned Kutas:

  • varna
  • vashya
  • tara
  • yoni
  • graha_maitri
  • gana
  • bhakoot
  • nadi

Doshas — POST /v1/vedic/relationships/doshas

Manglik / Kuja Dosha, Nadi Dosha, Bhakoot Dosha, and Graha Maitri stress with evidence and cancellation notes.

Kuja/Manglik checks Mars from Lagna, Moon, and Venus using the traditional 1, 2, 4, 7, 8, and 12 houses. Nadi and Bhakoot doshas can include cancellation evidence, such as different padas in the same nakshatra, same Moon-sign lord, or mutually friendly Moon-sign lords.

{
  "chart_a_id": "chart_a",
  "chart_b_id": "chart_b",
  "method_version": "vedic-relationship-v1",
  "doshas": [
    {
      "name": "kuja_manglik_dosha",
      "is_present": true,
      "severity": "low",
      "evidence": ["chart_a: Mars is 7 from Lagna"],
      "cancellations": ["chart_a: Mars is in own sign aries"]
    }
  ],
  "features_used": ["…"]
}

severity is one of none, low, medium, or high.

Highlights — POST /v1/vedic/relationships/highlights

Frontend-ready compatibility highlights, overlays, and Upapada comparison.

{
  "chart_a_id": "chart_a",
  "chart_b_id": "chart_b",
  "method_version": "vedic-relationship-v1",
  "ashtakoota_total": 27,
  "highlights": [
    {
      "kind": "ashtakoota",
      "title": "Ashtakoota match",
      "polarity": "mixed",
      "priority": 90,
      "evidence": ["Total score 27/36"]
    }
  ],
  "overlays": [
    {
      "point": "venus",
      "chart_a_house_in_b": 7,
      "chart_b_house_in_a": 5,
      "polarity": "supportive",
      "evidence": ["Chart A venus falls in Chart B house 7"]
    }
  ],
  "upapada": {
    "chart_a_sign": "taurus",
    "chart_b_sign": "libra",
    "distance_a_to_b": 6,
    "distance_b_to_a": 8,
    "polarity": "challenging",
    "evidence": ["Distances are 6/8"]
  },
  "features_used": ["…"]
}

Overlay points:

  • Venus
  • Mars
  • Jupiter
  • Moon
  • Lagna / Ascendant

Topics — POST /v1/vedic/relationships/topics

Relationship topic cards for UI sections.

{
  "chart_a_id": "chart_a",
  "chart_b_id": "chart_b",
  "method_version": "vedic-relationship-v1",
  "topics": [
    {
      "kind": "emotional_rapport",
      "title": "Emotional rapport",
      "polarity": "supportive",
      "priority": 80,
      "evidence": ["Chart A moon falls in Chart B house 5"]
    }
  ],
  "features_used": ["…"]
}

Topic kinds:

  • emotional_rapport
  • affection
  • desire_conflict
  • shared_growth
  • life_direction