---
title: "Marriage compatibility"
method: POST
path: "/marriage-match"
tags: ["Birth charts & matching"]
---

# Marriage compatibility

`POST /marriage-match`

## Request

- Base URL: `https://jagannatha-hora-359167915530.europe-west1.run.app`
- URL: `https://jagannatha-hora-359167915530.europe-west1.run.app/marriage-match`
- Auth: none declared

Ashtakoota (Guna Milan) and the additional poruthams for North Indian matching, the ten poruthams for South Indian matching, each person's nakshatra and rasi, their dosha scores, and the Beeja and Kshetra rasi.

Rate limit: 30 requests a minute per IP.

## Request body

- object
  - `boy_birth_details` object, required: The boy's birth details.
    - `date` string, required: Birth date, YYYY-MM-DD. Years 1800 to 2100.
    - `time` string, required: Birth time, HH:MM:SS on a 24-hour clock.
    - `latitude` number, required: Decimal degrees, north positive. Places beyond about 66.5° north or south (inside the polar circles) are rejected with 422.
    - `longitude` number, required: Decimal degrees, -180 to 180, east positive.
    - `timezone` number, required: UTC offset in hours, -12 to 14. The API works out the historically correct offset for the place and date from the coordinates, and uses this value only where no time zone is known there.
    - `elevation` number: Metres above sea level.
  - `girl_birth_details` object, required: The girl's birth details.
    - `date` string, required: Birth date, YYYY-MM-DD. Years 1800 to 2100.
    - `time` string, required: Birth time, HH:MM:SS on a 24-hour clock.
    - `latitude` number, required: Decimal degrees, north positive. Places beyond about 66.5° north or south (inside the polar circles) are rejected with 422.
    - `longitude` number, required: Decimal degrees, -180 to 180, east positive.
    - `timezone` number, required: UTC offset in hours, -12 to 14. The API works out the historically correct offset for the place and date from the coordinates, and uses this value only where no time zone is known there.
    - `elevation` number: Metres above sea level.

## Response `200`

Success

- object
  - `boy` object: Each person's nakshatra, pada and rasi. Keys: nakshatra_number, nakshatra_name, pada_number, raasi_number, raasi_name.
  - `girl` object: Each person's nakshatra, pada and rasi. Keys: nakshatra_number, nakshatra_name, pada_number, raasi_number, raasi_name.
  - `north_indian` object: Ashtakoota matching. Keys: match_system, eight_koota_porutham, four_additional_porutham, overall_compatibility.
  - `south_indian` object: Ten-porutham matching. Keys: match_system, ten_porutham, overall_compatibility.
  - `boy_dosha_data` object: Dosha scores for each person. Keys: mars_dosha, sun_dosha, saturn_dosha, rahu_ketu_dosha, total_dosha.
  - `girl_dosha_data` object: Dosha scores for each person. Keys: mars_dosha, sun_dosha, saturn_dosha, rahu_ketu_dosha, total_dosha.
  - `beeja_rasi` unknown
  - `kshetra_rasi` unknown
  - `engine_revision` unknown

## Other responses

- `400`: The input cannot be used for this calculation. The detail says why.
- `422`: A field is missing or out of range. The detail says which.
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/jagannathahora/apis/vedic-astrology-calculation-api.md) · [All operations](https://skmtc.dev/jagannathahora/apis/vedic-astrology-calculation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/jagannathahora/apis/vedic-astrology-calculation-api/revisions/bb90e41e2ba1?raw)