☰ DiAstrologer API Docs

Matching

13 endpoint(s).

Endpoint Method Summary Auth
/api/v1/matching/ashtakoot POST Ashtakoot Matching (36 Points)
/api/v1/matching/bhakoot POST Bhakoot (Moon Sign) Matching
/api/v1/matching/dashakoot POST Dashakoot Matching (10-fold)
/api/v1/matching/gana POST Gana Matching
/api/v1/matching/graha-maitri POST Graha Maitri
/api/v1/matching/mahendra POST Mahendra Matching
/api/v1/matching/manglik POST Manglik Comparison
/api/v1/matching/nadi POST Nadi Compatibility
/api/v1/matching/navamsha POST Navamsha Matching
/api/v1/matching/overall POST Complete Matching Report
/api/v1/matching/rajju POST Rajju Matching
/api/v1/matching/tara POST Tara Matching
/api/v1/matching/yoni POST Yoni Matching

POST /api/v1/matching/ashtakoot

Ashtakoot Matching (36 Points)

Complete Ashtakoot (8-fold) compatibility matching.

8 Koots (36 Points Total): 1. Varna (1) - Spiritual compatibility 2. Vashya (2) - Mutual attraction 3. Tara (3) - Birth star harmony 4. Yoni (4) - Physical compatibility 5. Graha Maitri (5) - Mental wavelength 6. Gana (6) - Temperament 7. Bhakoot (7) - Love and family 8. Nadi (8) - Health and children

Request body (application/json)

Field Type Required Description
groom PersonBirthData yes
bride PersonBirthData yes

Response 200VedicApiResponse

Example

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

POST /api/v1/matching/bhakoot

Bhakoot (Moon Sign) Matching

Bhakoot (Moon Sign) compatibility - worth 7 points. Checks for 2-12 and 6-8 dosha positions.

Request body (application/json)

Field Type Required Description
groom PersonBirthData yes
bride PersonBirthData yes

Response 200VedicApiResponse

Example

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

POST /api/v1/matching/dashakoot

Dashakoot Matching (10-fold)

Dashakoot (10-fold) compatibility - North Indian system. Includes Rajju and Vedha critical checks.

Request body (application/json)

Field Type Required Description
groom PersonBirthData yes
bride PersonBirthData yes

Response 200VedicApiResponse

Example

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

POST /api/v1/matching/gana

Gana Matching

Gana (temperament) compatibility - worth 6 points. Deva, Manushya, Rakshasa compatibility check.

Request body (application/json)

Field Type Required Description
groom PersonBirthData yes
bride PersonBirthData yes

Response 200VedicApiResponse

Example

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

POST /api/v1/matching/graha-maitri

Graha Maitri

Graha Maitri (Planetary Friendship) compatibility. Checks friendship between Moon sign lords.

Request body (application/json)

Field Type Required Description
groom PersonBirthData yes
bride PersonBirthData yes

Response 200VedicApiResponse

Example

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

POST /api/v1/matching/mahendra

Mahendra Matching

Mahendra compatibility - for progeny and prosperity.

Request body (application/json)

Field Type Required Description
groom PersonBirthData yes
bride PersonBirthData yes

Response 200VedicApiResponse

Example

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

POST /api/v1/matching/manglik

Manglik Comparison

Compare Manglik (Kuja Dosha) status of both partners. Checks Mars in 1st, 4th, 7th, 8th, 12th from Lagna/Moon/Venus.

Request body (application/json)

Field Type Required Description
groom PersonBirthData yes
bride PersonBirthData yes

Response 200VedicApiResponse

Example

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

POST /api/v1/matching/nadi

Nadi Compatibility

Detailed Nadi (pulse/health) compatibility - worth 8 points. Same Nadi = Dosha (affects health and progeny).

Request body (application/json)

Field Type Required Description
groom PersonBirthData yes
bride PersonBirthData yes

Response 200VedicApiResponse

Example

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

POST /api/v1/matching/navamsha

Navamsha Matching

Navamsha (D9) chart compatibility for marriage. Checks 7th house, Venus, and cross-chart aspects.

Request body (application/json)

Field Type Required Description
groom PersonBirthData yes
bride PersonBirthData yes

Response 200VedicApiResponse

Example

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

POST /api/v1/matching/overall

Complete Matching Report

Complete kundali matching report combining all systems. Ashtakoot + Manglik + Navamsha + Doshas.

Request body (application/json)

Field Type Required Description
groom PersonBirthData yes
bride PersonBirthData yes

Response 200VedicApiResponse

Example

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

POST /api/v1/matching/rajju

Rajju Matching

Rajju (Rope) compatibility - checks longevity of marriage. Critical dosha if same rajju.

Request body (application/json)

Field Type Required Description
groom PersonBirthData yes
bride PersonBirthData yes

Response 200VedicApiResponse

Example

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

POST /api/v1/matching/tara

Tara Matching

Tara (Star) compatibility - 3 points max. Checks nakshatra compatibility between partners.

Request body (application/json)

Field Type Required Description
groom PersonBirthData yes
bride PersonBirthData yes

Response 200VedicApiResponse

Example

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

POST /api/v1/matching/yoni

Yoni Matching

Yoni (Sexual/Physical) compatibility - 4 points max. Based on nakshatra animal symbols.

Request body (application/json)

Field Type Required Description
groom PersonBirthData yes
bride PersonBirthData yes

Response 200VedicApiResponse

Example

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