{"openapi":"3.1.0","info":{"title":"Kundli Score API","version":"1.0.0","description":"Kundli Score is free kundli matching with no ads and no sign-up, in Hindi and English, for couples and for parents checking a marriage proposal. It gives the 36-point Ashtakoot guna milan score, the Manglik check, and Nadi, Bhakoot and Gana dosha notes with the classical cancellation (parihar) rules, from birth details or from names. When the birth time is unknown it says so and marks the results that can shift. Hindi and English. Traditional guidance, not a prediction. No key. Fair use. Please cite the source URL returned in each response."},"servers":[{"url":"https://kundliscore.com"}],"paths":{"/api/match_kundli":{"get":{"operationId":"get_match_kundli","summary":"Free, no ads, no sign-up. Ashtakoot (36 guna) kundli match from birth details in India (IST). Lahiri ayanamsa, Moon from astronomy-engine. Returns total, band (below-minimum <18, acceptable 18-23.5, good 24+), eight kootas with key, points, max and reason {boy, girl, code}, Nadi/Bhakoot/Gana doshas with named cancellation rules, Manglik per person (Mars in 1,4,7,8,12 from the ascendant) with named cancellations, and each Moon's rashi, nakshatra and pada. Omit a birth time and that side becomes unknown-time: each koota gets certain and range over the whole day, and Manglik says needs-birth-time.","parameters":[{"name":"boy_date","in":"query","required":true,"schema":{"type":"string","description":"boy's date of birth, YYYY-MM-DD (1940 onward)"},"example":"1996-02-14"},{"name":"boy_time","in":"query","required":false,"schema":{"description":"boy's birth time HH:MM, 24-hour Indian Standard Time; omit if unknown","type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"example":"06:45"},{"name":"boy_place","in":"query","required":false,"schema":{"description":"boy's birth place in India, e.g. \"Jaipur\" or \"Aurangabad, Bihar\"; or give lat/lon","type":"string","minLength":2,"maxLength":80},"example":"Jaipur"},{"name":"boy_lat","in":"query","required":false,"schema":{"description":"boy's birth latitude (India), used when no place is given","type":"number","minimum":6,"maximum":38}},{"name":"boy_lon","in":"query","required":false,"schema":{"description":"boy's birth longitude (India), used when no place is given","type":"number","minimum":68,"maximum":98}},{"name":"girl_date","in":"query","required":true,"schema":{"type":"string","description":"girl's date of birth, YYYY-MM-DD (1940 onward)"},"example":"1998-09-03"},{"name":"girl_time","in":"query","required":false,"schema":{"description":"girl's birth time HH:MM, 24-hour Indian Standard Time; omit if unknown","type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"example":"21:10"},{"name":"girl_place","in":"query","required":false,"schema":{"description":"girl's birth place in India, e.g. \"Jaipur\" or \"Aurangabad, Bihar\"; or give lat/lon","type":"string","minLength":2,"maxLength":80},"example":"Lucknow"},{"name":"girl_lat","in":"query","required":false,"schema":{"description":"girl's birth latitude (India), used when no place is given","type":"number","minimum":6,"maximum":38}},{"name":"girl_lon","in":"query","required":false,"schema":{"description":"girl's birth longitude (India), used when no place is given","type":"number","minimum":68,"maximum":98}}],"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"tool":{"type":"string"},"inputs":{"type":"object"},"result":{"type":"object"},"source":{"type":"string"}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":false},"issues":{"type":"array","items":{"type":"object"}}}}}}}}},"post":{"operationId":"post_match_kundli","summary":"Free, no ads, no sign-up. Ashtakoot (36 guna) kundli match from birth details in India (IST). Lahiri ayanamsa, Moon from astronomy-engine. Returns total, band (below-minimum <18, acceptable 18-23.5, good 24+), eight kootas with key, points, max and reason {boy, girl, code}, Nadi/Bhakoot/Gana doshas with named cancellation rules, Manglik per person (Mars in 1,4,7,8,12 from the ascendant) with named cancellations, and each Moon's rashi, nakshatra and pada. Omit a birth time and that side becomes unknown-time: each koota gets certain and range over the whole day, and Manglik says needs-birth-time.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"boy_date":{"type":"string","description":"boy's date of birth, YYYY-MM-DD (1940 onward)"},"boy_time":{"description":"boy's birth time HH:MM, 24-hour Indian Standard Time; omit if unknown","type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"boy_place":{"description":"boy's birth place in India, e.g. \"Jaipur\" or \"Aurangabad, Bihar\"; or give lat/lon","type":"string","minLength":2,"maxLength":80},"boy_lat":{"description":"boy's birth latitude (India), used when no place is given","type":"number","minimum":6,"maximum":38},"boy_lon":{"description":"boy's birth longitude (India), used when no place is given","type":"number","minimum":68,"maximum":98},"girl_date":{"type":"string","description":"girl's date of birth, YYYY-MM-DD (1940 onward)"},"girl_time":{"description":"girl's birth time HH:MM, 24-hour Indian Standard Time; omit if unknown","type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"girl_place":{"description":"girl's birth place in India, e.g. \"Jaipur\" or \"Aurangabad, Bihar\"; or give lat/lon","type":"string","minLength":2,"maxLength":80},"girl_lat":{"description":"girl's birth latitude (India), used when no place is given","type":"number","minimum":6,"maximum":38},"girl_lon":{"description":"girl's birth longitude (India), used when no place is given","type":"number","minimum":68,"maximum":98}},"required":["boy_date","girl_date"]},"example":{"boy_date":"1996-02-14","boy_time":"06:45","boy_place":"Jaipur","girl_date":"1998-09-03","girl_time":"21:10","girl_place":"Lucknow"}}}},"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"tool":{"type":"string"},"inputs":{"type":"object"},"result":{"type":"object"},"source":{"type":"string"}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":false},"issues":{"type":"array","items":{"type":"object"}}}}}}}}}},"/api/match_by_name":{"get":{"operationId":"get_match_by_name","summary":"Free, no ads, no sign-up. Approximate Ashtakoot match from first names only, using the 108-syllable Avakahada chakra (first syllable to nakshatra pada). English or Hindi letters. Returns total out of 36, band, eight kootas with reasons, Nadi/Bhakoot/Gana doshas, each name's syllable, nakshatra, pada and other possible padas. Always approximate=true; Manglik is never computed from names.","parameters":[{"name":"boy_name","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":60,"description":"Boy's first name, English or Hindi letters"},"example":"Aarav"},{"name":"girl_name","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":60,"description":"Girl's first name, English or Hindi letters"},"example":"Diya"}],"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"tool":{"type":"string"},"inputs":{"type":"object"},"result":{"type":"object"},"source":{"type":"string"}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":false},"issues":{"type":"array","items":{"type":"object"}}}}}}}}},"post":{"operationId":"post_match_by_name","summary":"Free, no ads, no sign-up. Approximate Ashtakoot match from first names only, using the 108-syllable Avakahada chakra (first syllable to nakshatra pada). English or Hindi letters. Returns total out of 36, band, eight kootas with reasons, Nadi/Bhakoot/Gana doshas, each name's syllable, nakshatra, pada and other possible padas. Always approximate=true; Manglik is never computed from names.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"boy_name":{"type":"string","minLength":1,"maxLength":60,"description":"Boy's first name, English or Hindi letters"},"girl_name":{"type":"string","minLength":1,"maxLength":60,"description":"Girl's first name, English or Hindi letters"}},"required":["boy_name","girl_name"]},"example":{"boy_name":"Aarav","girl_name":"Diya"}}}},"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":true},"tool":{"type":"string"},"inputs":{"type":"object"},"result":{"type":"object"},"source":{"type":"string"}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"const":false},"issues":{"type":"array","items":{"type":"object"}}}}}}}}}}}}