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 200 — VedicApiResponse
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 200 — VedicApiResponse
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 200 — VedicApiResponse
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 200 — VedicApiResponse
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 200 — VedicApiResponse
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 200 — VedicApiResponse
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 200 — VedicApiResponse
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 200 — VedicApiResponse
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 200 — VedicApiResponse
Example
curl -X POST 'https://api.example.com/api/v1/vivaha/verdict' \
-H 'Authorization: Bearer <API_KEY>'