{"id":"vedic/gun-milan","method":"POST","url":"https://astro-agents-api.vercel.app/v1/vedic/gun-milan","price_usd":"0.25","tier":"premium","title":"Gun Milan (Ashtakoota matching)","summary":"36-point Ashtakoota marriage compatibility: all 8 kootas with reasons, doshas and Manglik check.","description":"Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot and Nadi scored from both Moons, each with the attributes and rule behind the score, Nadi/Bhakoot dosha flags with commonly cited cancellations, and both partners' Manglik status. Boy = person_a, girl = person_b by convention.","input_schema":{"type":"object","required":["person_a","person_b"],"properties":{"person_a":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"date":{"type":"string","description":"YYYY-MM-DD (use with 'time' instead of 'datetime')."},"time":{"type":"string","description":"HH:MM or HH:MM:SS, 24 h. Omit if unknown (computed at 12:00 with a TIME_UNKNOWN warning)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."},"ambiguous_time":{"type":"string","enum":["earlier","later"],"default":"earlier","description":"Which occurrence to use when a local time happens twice (DST fall-back)."}},"required":["latitude","longitude"],"description":"Groom / boy (traditional convention)."},"person_b":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"date":{"type":"string","description":"YYYY-MM-DD (use with 'time' instead of 'datetime')."},"time":{"type":"string","description":"HH:MM or HH:MM:SS, 24 h. Omit if unknown (computed at 12:00 with a TIME_UNKNOWN warning)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."},"ambiguous_time":{"type":"string","enum":["earlier","later"],"default":"earlier","description":"Which occurrence to use when a local time happens twice (DST fall-back)."}},"required":["latitude","longitude"],"description":"Bride / girl."},"options":{"type":"object","properties":{"ayanamsa":{"type":"string","enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"default":"lahiri"},"node_type":{"type":"string","enum":["mean","true"],"default":"mean","description":"Rahu/Ketu from the mean or the true (osculating) lunar node."},"house_system":{"type":"string","enum":["whole_sign","equal","placidus","porphyry","koch"],"default":"whole_sign","description":"Bhava system; 'equal' puts the lagna degree mid-house."},"include_outer_planets":{"type":"boolean","default":false}}}}},"example_request":{"person_a":{"datetime":"1990-05-15T14:30","latitude":28.6139,"longitude":77.209},"person_b":{"datetime":"1992-08-03T09:15","latitude":19.076,"longitude":72.8777}},"example_response":{"endpoint":"vedic/gun-milan","result":{"settings":{"zodiac":"sidereal","ayanamsa":{"name":"lahiri","true_deg":23.725764,"mean_deg":23.722507,"true_dms":"23°43'33\""},"node_type":"mean","house_system":"whole_sign","varga_rules":"Parashara (BPHS); D24 counts forward from Cancer in even signs","ruleset":"ashtakoota-north-indian/majority-v1","convention":"person_a = groom/boy, person_b = bride/girl"},"person_a":{"subject":{"time":{"local_input":"1990-05-15T14:30","time_basis":"civil","timezone":"Asia/Kolkata","timezone_source":"resolved_from_coordinates","utc_offset":"+05:30","is_dst":false,"utc":"1990-05-15T09:00:00Z","julian_day_ut":2448026.875001,"julian_day_tt":2448026.875662,"delta_t_seconds":57.139,"time_known":true,"local_mean_time":"1990-05-15T14:08:50","true_solar_time":"1990-05-15T14:12:32","equation_of_time_minutes":3.7067}},"moon":{"longitude":271.893763,"rashi_index":9,"sign":"Capricorn","nakshatra_index":20,"nakshatra":"Uttara Ashadha","pada":2,"varna":"Vaishya","vashya":"Chatushpada","yoni":"Mongoose","gana":"Manushya","nadi":"Antya","rashi_lord":"Saturn"}},"person_b":{"subject":{"time":{"local_input":"1992-08-03T09:15","time_basis":"civil","timezone":"Asia/Kolkata","timezone_source":"resolved_from_coordinates","utc_offset":"+05:30","is_dst":false,"utc":"1992-08-03T03:45:00Z","julian_day_ut":2448837.656255,"julian_day_tt":2448837.656935,"delta_t_seconds":58.788,"time_known":true,"local_mean_time":"1992-08-03T08:36:30","true_solar_time":"1992-08-03T08:30:21","equation_of_time_minutes":-6.1484}},"moon":{"longitude":167.934588,"rashi_index":5,"sign":"Virgo","nakshatra_index":12,"nakshatra":"Hasta","pada":3,"varna":"Vaishya","vashya":"Manava","yoni":"Buffalo","gana":"Deva","nadi":"Adi","rashi_lord":"Mercury"}},"kootas":{"varna":{"score":1,"boy":"Vaishya","girl":"Vaishya","rule":"1 point if VARNA_RANK[groom] >= VARNA_RANK[bride], else 0","max":1},"vashya":{"score":1.0,"boy":"Chatushpada","girl":"Manava","rule":"group by Moon sign (Sagittarius and Capricorn split at 15 deg); groom row x bride column","max":2},"tara":{"score":3.0,"girl_to_boy":{"remainder":9,"tara":"Parama Mitra","auspicious":true},"boy_to_girl":{"remainder":2,"tara":"Sampat","auspicious":true},"rule":"count = ((to_nak - from_nak) % 27) + 1 (inclusive); remainder = count % 9, with 0 read as 9. Do this bride->groom and groom->bride. Each direction whose remainder is not in {3,5,7} scores 1.5; the total is 0, 1.5 or 3.","max":3},"yoni":{"score":2,"boy":"Mongoose","girl":"Buffalo","sworn_enemies":false,"rule":"14x14 yoni matrix: same 4, friendly 3, neutral 2, inimical 1, sworn enemies 0","max":4},"graha_maitri":{"score":4,"boy_lord":"Saturn","girl_lord":"Mercury","boy_lord_sees_girl_lord_as":"friend","girl_lord_sees_boy_lord_as":"neutral","rule":"naisargika friendship of the Moon-sign lords: FF 5, FN 4, NN 3, FE 1, NE 0.5, EE 0","max":5},"gana":{"score":6,"boy":"Manushya","girl":"Deva","rule":"3x3 gana matrix, groom row x bride column","max":6},"bhakoot":{"score":0,"boy_sign":"Capricorn","girl_sign":"Virgo","distance":"9/5","rule":"0 for sign distances 2/12, 5/9, 6/8; otherwise 7","max":7},"nadi":{"score":8,"boy":"Antya","girl":"Adi","rule":"8 if the nadis differ, else 0 (nadi dosha). Same nakshatra is still 0 in the score.","max":8}},"total":25.0,"max":36,"verdict":"25-32: good match","doshas":{"bhakoot_dosha":{"present":true,"type":"9/5","commonly_cited_cancellations_present":[],"cancellation_rules":[]}},"manglik":{"person_a":{"present":true,"severity":"mild","rule":"Mars in house [1, 2, 4, 7, 8, 12] counted by sign from the lagna or the Moon (Venus reported for reference)","mars_sign":"Aquarius","from":{"lagna":{"mars_house":6,"manglik":false},"moon":{"mars_house":2,"manglik":true},"venus":{"mars_house":12,"manglik":true}},"counted_from_with_dosha":["moon","venus"],"commonly_cited_cancellations_present":[],"note":"Matching two manglik charts is traditionally held to neutralise the dosha."},"person_b":{"present":false,"severity":"none","rule":"Mars in house [1, 2, 4, 7, 8, 12] counted by sign from the lagna or the Moon (Venus reported for reference)","mars_sign":"Taurus","from":{"lagna":{"mars_house":10,"manglik":false},"moon":{"mars_house":9,"manglik":false},"venus":{"mars_house":10,"manglik":false}},"counted_from_with_dosha":[],"commonly_cited_cancellations_present":[],"note":"Matching two manglik charts is traditionally held to neutralise the dosha."},"match":"only one partner is manglik: traditionally a concern (check the cancellations listed)"}},"meta":{"engine":"astro-agents/1.0.1","ephemeris":"NASA/JPL DE440 (1800-01-01..2200-01-01)","astronomy_library":"skyfield/1.55","frame":"geocentric apparent positions, true ecliptic and equinox of date (IAU 2006/2000A)","deterministic":true,"llm_used":false,"input_sha256":"333503420c23e7efab574e1d03ea74ac43b2938a4c0e025e133e3e28d45baf64","result_sha256":"a935a8920bb8bd214b49237d32b2dfcd3f79b101265f3010cc120b2572097246","reproducibility":"result_sha256 = SHA-256 of the result serialized as JSON with sorted keys, no whitespace, UTF-8, floats rounded to 6 decimals. Same input + same engine version => same hash."},"example_note":"real output of engine 1.0.1; lists shortened to 3 items"},"payment":"x402 or MPP; first calls free. POST without payment to receive the 402 challenge.","catalog":"https://astro-agents-api.vercel.app/v1/catalog"}