/api/astro/horoscope-match/1 creditMarriage matching
Full Ashtakoota marriage matching from two birth records rather than two star numbers. Give the date, time and place of each partner and the endpoint derives the moon sign, nakshatra and pada itself, scores the eight kootas out of 36, checks for the two blocking doshas and returns a verdict. The response has four parts. `boy` and `girl` summarise each chart: moon sign, nakshatra name and number, pada, moon longitude and ascendant sign. `gunas` is a list of eight objects, one per koota, each with its `key` and `label`, `max_points` and `obtained_points`, the `boy_value` and `girl_value` being compared (the varna, the yoni animal, the gana and so on), the `area_of_life` it governs and a plain-English `description` — enough to render a results table without writing any copy. Then come `total_score`, `max_score` of 36 and `minimum_recommended_score` of 18. Finally `doshas`, `verdict` and `verdict_reason`. A Nadi score of zero raises Nadi Dosha and a Bhakoot score of zero raises Bhakoot Dosha, and either makes the verdict 'Union is NOT Recommended' whatever the total; otherwise 28 or more is 'Union is Excellent', 18 or more is 'Union is Good', and below that is not recommended. Each partner object takes `date_time`, `latitude`, `longitude` and `timezone_as_float`, plus optional `name` and `city` labels that are echoed back untouched. Lahiri ayanamsa is always used; the `ayanamsa` field is accepted but has no effect.
https://yogataraapi.prahlad.app/api/astro/horoscope-match/Authentication
Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonRequest fields
| Field | Type | Required | Notes |
|---|---|---|---|
| boy | object | required | OBJECT with fixed keys: name (string, optional, free-form label), date_time (required, ISO-8601), latitude (required, -89.9..89.9), longitude (required, -180..180), timezone_as_float (required, -12.0..14.0), city (string, optional, free-form label). `name` and `city` are not validated and do not affect the calculation. |
| girl | object | required | OBJECT - same shape and rules as `boy`. |
| ayanamsa | string | optional |
Example request
curl -X POST https://yogataraapi.prahlad.app/api/astro/horoscope-match/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"boy":{"date_time":"2026-09-01T06:00:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5},"girl":{"date_time":"2026-09-01T06:00:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}}'Response
{
"data": {
"boy": {
"name": "",
"city": "",
"moon_sign": "Aries",
"nakshatra": "Ashwini",
"nakshatra_number": 1,
"paadha_number": 1,
"moon_longitude": 1.478,
"ascendant_sign": "Leo"
},
"girl": {
"name": "",
"city": "",
"moon_sign": "Aries",
"nakshatra": "Ashwini",
"nakshatra_number": 1,
"paadha_number": 1,
"moon_longitude": 1.478,
"ascendant_sign": "Leo"
},
"gunas": [
{
"key": "varna",
"label": "Varna",
"max_points": 1,
"obtained_points": 1,
"boy_value": "Brahmin",
"girl_value": "Brahmin",
"area_of_life": "Obedience",
"description": "Varna Kuta is assigned 1 point. It represents mutual love, comfort and obedience - the spiritual compatibility between the couple."
},
{
"key": "vashya",
"label": "Vashya",
"max_points": 2,
"obtained_points": 2,
"boy_value": "Chatushpada",
"girl_value": "Chatushpada",
"area_of_life": "Mutual Control",
"description": "Vashya Kuta is assigned 2 points. It represents mutual control or dominance, along with friendship and amenability between the couple."
},
{
"key": "tara",
"label": "Tara",
"max_points": 3,
"obtained_points": 3,
"boy_value": "Sampat",
"girl_value": "Sampat",
"area_of_life": "Luck",
"description": "Tara Kuta is assigned 3 points. It represents luck, auspiciousness and the transmission of mutual well-being between the couple."
},
{
"key": "yoni",
"label": "Yoni",
"max_points": 4,
"obtained_points": 4,
"boy_value": "Horse",
"girl_value": "Horse",
"area_of_life": "Sexual Aspects",
"description": "Yoni Kuta is assigned 4 points. It represents sexual aspects, including compatibility of intimate temperament."
},
{
"key": "maitri",
"label": "Maitri",
"max_points": 5,
"obtained_points": 5,
"boy_value": "Mars",
"girl_value": "Mars",
"area_of_life": "Affection",
"description": "Maitri (Graha Maitri) Kuta is assigned 5 points. It represents psychological disposition, mental qualities and affection between the couple."
},
{
"key": "gana",
"label": "Gana",
"max_points": 6,
"obtained_points": 6,
"boy_value": "Deva",
"girl_value": "Deva",
"area_of_life": "Nature",
"description": "Gana Kuta is assigned 6 points. It represents nature, temperament, longevity, wealth and love."
},
{
"key": "bhakoot",
"label": "Bhakoot",
"max_points": 7,
"obtained_points": 7,
"boy_value": "Mesha",
"girl_value": "Mesha",
"area_of_life": "Love",
"description": "Bhakoot (Rashi) Kuta is assigned 7 points. It represents children, wealth, comfort, good luck and growth of the family."
},
{
"key": "nadi",
"label": "Nadi",
"max_points": 8,
"obtained_points": 0,
"boy_value": "Aadi",
"girl_value": "Aadi",
"area_of_life": "Health",
"description": "Nadi Kuta is assigned 8 points, the most important of all. It represents temperament, health, and genetic compatibility for progeny."
}
],
"total_score": 28,
"max_score": 36,
"minimum_recommended_score": 18,
"doshas": [
"Nadi Dosha"
],
"verdict": "Union is NOT Recommended",
"verdict_reason": "due to Nadi Dosha"
},
"message": "successful",
"is_error": false
}Captured from a real call using the exact request above. Results sit under data.
Errors
Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.