🏠 Vastu API and ✋ Palmistry API are now live. Ship them in your app today.

Match Ashtakoot Report

The match_ashtakoot_report API generates a detailed Kundli matching report for a prospective bride and groom using the traditional Ashtakoot Guna Milan system. It compares their birth details, including date, time, and place of birth, to calculate compatibility across eight Koots: Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, and Nadi.

The report includes the Guna Milan score out of 36, individual scores for each Koot, and related astrological details used to assess compatibility. It helps astrology platforms provide users with a structured view of traditional horoscope matching, including areas such as temperament, mutual understanding, and other factors considered in Vedic marriage matching.

POSThttps://json.astrologyapi.com/v1/match_ashtakoot_report

Authentication

x-astrologyapi-keystringrequired

API access token used to authenticate requests. Send your access token in this custom header.

Accept-Languagestring

Preferred language for the response content. Supported: English - en.

Body parameters

m_dayintrequired

Male birth day, eg: 11

m_monthintrequired

Male birth month, eg: 1

m_yearintrequired

Male birth year, eg: 2004

m_hourintrequired

Male birth hour, eg: 5

m_minintrequired

Male birth minute, eg: 0

m_latfloatrequired

Male birth latitude, eg: 28.031

m_lonfloatrequired

Male birth longitude, eg: 79.127

m_tzonefloatrequired

Male birth timezone, eg: 5.5

f_dayintrequired

Female birth day, eg: 2

f_monthintrequired

Female birth month, eg: 2

f_yearintrequired

Female birth year, eg: 2004

f_hourintrequired

Female birth hour, eg: 4

f_minintrequired

Female birth minute, eg: 0

f_latfloatrequired

Female birth latitude, eg: 28.36

f_lonfloatrequired

Female birth longitude, eg: 79.430

f_tzonefloatrequired

Female birth timezone, eg: 5.5

curl --location 'https://json.astrologyapi.com/v1/match_ashtakoot_report' \
  --header 'Content-Type: application/json' \
  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
  --data '{
    "m_day": 11,
    "m_month": 1,
    "m_year": 2004,
    "m_hour": 5,
    "m_min": 0,
    "m_lat": 28.031,
    "m_lon": 79.127,
    "m_tzone": 5.5,
    "f_day": 2,
    "f_month": 2,
    "f_year": 2004,
    "f_hour": 4,
    "f_min": 0,
    "f_lat": 28.36,
    "f_lon": 79.43,
    "f_tzone": 5.5
}'
Try it

Runs with sample data — no API key needed

{
  "varna": {
    "description": "Natural Refinement  / Work",
    "male_koot_attribute": "Kshatriya",
    "female_koot_attribute": "Vaishya",
    "total_points": 1,
    "received_points": 1,
    "male_point": 5,
    "female_point": 2,
    "prediction": "Being not very compatible with one another, you may have a mediocre relationship. Different mindsets make it challenging to support one another. Hence work wise, you may remain quite ordinary. However, you are daring and do not deter from taking challenging tasks. Empathy and care for others is an innate trait in you."
  },
  "vashya": {
    "description": "Innate Giving / Attraction  towards each other",
    "male_koot_attribute": "Vanchar",
    "female_koot_attribute": "Chatuspad",
    "total_points": 2,
    "received_points": 0,
    "male_point": 5,
    "female_point": 1,
    "prediction": "Though you shall remain friends, mutual attraction would be average. There will not be much of mental and emotional differences. Differences of opinions shall hardly exist; neither shall there be any estrangement between you two."
  },
  "tara": {
    "description": "Comfort - Prosperity - Health",
    "male_koot_attribute": "Magha",
    "female_koot_attribute": "Mrigshira",
    "total_points": 3,
    "received_points": 1.5,
    "male_point": 5,
    "female_point": 6,
    "prediction": "Despite many hurdles, the financial situation shall not be that bad; it will remain average. There shall be minimum Ideological differences; you would not oppose each other. You shall be comfortable in each other’s company and maintain a normal relationship."
  },
  "yoni": {
    "description": "Intimate Physical",
    "male_koot_attribute": "Mooshak",
    "female_koot_attribute": "Sarp",
    "total_points": 4,
    "received_points": 1,
    "male_point": 7,
    "female_point": 4,
    "prediction": "As partners, you both have differences of opinion. You vary in your attitudes, demeanour and responses. With no common ground, you may find it hard to function as a team in your marital life. Cold vibes and an air of animosity may be evident, making you repel each other. This combination may not be advisable. "
  },
  "maitri": {
    "description": "Friendship",
    "male_koot_attribute": "Sun",
    "female_koot_attribute": "Venus",
    "total_points": 5,
    "received_points": 0,
    "male_point": 1,
    "female_point": 6,
    "prediction": "You shall share a friendly relationship with similar interests and opinions. You shall make optimum use of your political intelligence. You shall be successful in reaching high office. Religious sentiments shall be strong."
  },
  "gan": {
    "description": "Temperament",
    "male_koot_attribute": "Rakshasa",
    "female_koot_attribute": "Dev",
    "total_points": 6,
    "received_points": 1,
    "male_point": 3,
    "female_point": 1,
    "prediction": "The differences in the mental make-up would significantly give rise to a lot many contradictions between the two of you proving detrimental to the relationship. Physical attraction, mental agreement and joyous camaraderie crystallize a healthy association. But this alliance lacks in the basic ingredients of love, attraction and fondness. It’s only when hearts grow fonder, associations thrive the test of time. With no overlapping in the attitudes, embitterment, dissatisfaction and unhappiness shall give lethal blows to this already agitated alliance. You will be unable to adjust with each other which shall further strain your life with each other."
  },
  "bhakut": {
    "description": "Constructive Ability / Constructivism / Society and Couple",
    "male_koot_attribute": "Leo",
    "female_koot_attribute": "Taurus",
    "total_points": 7,
    "received_points": 7,
    "male_point": 5,
    "female_point": 2,
    "prediction": "Mutual love, fondness and magnetism shall be in moderate quantities, your alliance will be well balanced. You will share a good rapport and the differences in opinions or bickering shall hardly be a possibility. Your creative abilities will be average."
  },
  "nadi": {
    "description": "Progeny / Excess",
    "male_koot_attribute": "Ant",
    "female_koot_attribute": "Madhya",
    "total_points": 8,
    "received_points": 8,
    "male_point": 1,
    "female_point": 3,
    "prediction": "There shall be differences but they will be negligible enough to create any kind of discord or discomfort. Your opinions and views shall synchronize which will lead to harmonizing this relationship imparting meaning and happiness to it. With similarities in mental constitution, this coalition will be  attractive and delightful."
  },
  "total": {
    "total_points": 36,
    "received_points": 19.5,
    "minimum_required": 18
  },
  "conclusion": {
    "status": false,
    "report": "The match has scored 19.5 points outs of 36 points. This is quite good score."
  }
}