☰ DiAstrologer API Docs

Vivaha (Marriage) Compatibility

9 endpoint(s).

Endpoint Method Summary Auth
/api/v1/vivaha/analyze POST Analyze Vivaha Compatibility
/api/v1/vivaha/ashtakoot POST Ashtakoot Milan
/api/v1/vivaha/chapters GET List Vivaha Chapters
/api/v1/vivaha/manglik POST Manglik Dosha Check
/api/v1/vivaha/rules GET List Vivaha Rules
/api/v1/vivaha/rules/{rule_id} GET Get Vivaha Rule
/api/v1/vivaha/stats GET Get Vivaha Stats
/api/v1/vivaha/subcategories GET List Vivaha Subcategories
/api/v1/vivaha/verdict POST Marriage Verdict

POST /api/v1/vivaha/analyze

Analyze Vivaha Compatibility

Full Vivaha (Marriage) Compatibility Analysis.

Analyzes 12 sections: 1. Ashtakoot Milan (8 Kutas, 36 points) 2. Dashakoot Milan (10 Kutas with Rajju + Vedha) 3. Manglik Dosha Analysis 4. Navamsha (D9) Compatibility 5. Bhakoot Dosha 6. Graha Maitri 7. Dasha Compatibility 8. Marriage Timing 9. Marital Harmony 10. Progeny Compatibility 11. Dosha Remedies 12. Final Verdict

Source: Parashari Jyotish

Request body (application/json)

Field Type Required Description
person1 VivahaPerson yes First person (boy/groom)
person2 VivahaPerson yes Second person (girl/bride)

Response 200VedicApiResponse

Example

curl -X POST 'https://api.example.com/api/v1/vivaha/analyze' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/vivaha/ashtakoot

Ashtakoot Milan

Ashtakoot Milan (8 Kutas) - 36 Point Compatibility System.

Analyzes: - Varna (1 pt) - Spiritual compatibility - Vashya (2 pts) - Mutual attraction - Tara (3 pts) - Health & destiny - Yoni (4 pts) - Sexual compatibility - Graha Maitri (5 pts) - Mental compatibility - Gana (6 pts) - Temperament - Bhakoot (7 pts) - Love & prosperity - Nadi (8 pts) - Health of progeny

Total: 36 points Source: Classical Vedic texts

Request body (application/json)

Field Type Required Description
person1 VivahaPerson yes First person (boy/groom)
person2 VivahaPerson yes Second person (girl/bride)

Response 200VedicApiResponse

Example

curl -X POST 'https://api.example.com/api/v1/vivaha/ashtakoot' \
  -H 'Authorization: Bearer <API_KEY>'

GET /api/v1/vivaha/chapters

List Vivaha Chapters

List all 16 prakaranas (chapters) of Vivaha Vrindavan with rule counts.

Response 200VedicApiResponse

Example

curl -X GET 'https://api.example.com/api/v1/vivaha/chapters' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/vivaha/manglik

Manglik Dosha Check

Manglik Dosha Analysis for Both Persons.

Checks Mars placement in houses 1, 2, 4, 7, 8, 12 from: - Lagna - Moon - Venus

Includes cancellation conditions and compatibility assessment. Source: Classical Vedic texts

Request body (application/json)

Field Type Required Description
person1 VivahaPerson yes First person (boy/groom)
person2 VivahaPerson yes Second person (girl/bride)

Response 200VedicApiResponse

Example

curl -X POST 'https://api.example.com/api/v1/vivaha/manglik' \
  -H 'Authorization: Bearer <API_KEY>'

GET /api/v1/vivaha/rules

List Vivaha Rules

Browse rules with optional filters by chapter / category / subcategory.

Param In Type Required Description
chapter query any no Chapter number 1-16
category query any no muhurta | matching | dosha
subcategory query any no Topical slug, e.g. nadi_koota
limit query integer no
offset query integer no

Response 200VedicApiResponse

Example

curl -X GET 'https://api.example.com/api/v1/vivaha/rules' \
  -H 'Authorization: Bearer <API_KEY>'

GET /api/v1/vivaha/rules/{rule_id}

Get Vivaha Rule

Fetch a single rule by rule_id (e.g. VV_CH03_018).

Param In Type Required Description
rule_id path string yes

Response 200VedicApiResponse

Example

curl -X GET 'https://api.example.com/api/v1/vivaha/rules/${rule_id}' \
  -H 'Authorization: Bearer <API_KEY>'

GET /api/v1/vivaha/stats

Get Vivaha Stats

Aggregate stats: total rules, breakdown by chapter and category.

Response 200VedicApiResponse

Example

curl -X GET 'https://api.example.com/api/v1/vivaha/stats' \
  -H 'Authorization: Bearer <API_KEY>'

GET /api/v1/vivaha/subcategories

List Vivaha Subcategories

List all subcategories (topical tags) with rule counts.

Param In Type Required Description
chapter query any no Limit to chapter

Response 200VedicApiResponse

Example

curl -X GET 'https://api.example.com/api/v1/vivaha/subcategories' \
  -H 'Authorization: Bearer <API_KEY>'

POST /api/v1/vivaha/verdict

Marriage Verdict

Final Marriage Compatibility Verdict.

Returns: - Overall compatibility score - Recommendation (Excellent/Good/Average/Poor) - Key strengths - Key concerns - Summary assessment

Based on all 12 compatibility sections.

Request body (application/json)

Field Type Required Description
person1 VivahaPerson yes First person (boy/groom)
person2 VivahaPerson yes Second person (girl/bride)

Response 200VedicApiResponse

Example

curl -X POST 'https://api.example.com/api/v1/vivaha/verdict' \
  -H 'Authorization: Bearer <API_KEY>'