Get marriage compatibility report

Poll this endpoint after POST /marriage/report. Always returns HTTP 200 with a status field; the client polls until status is done or failed.

Request: Bearer token

Body: none

Success: 200 - body always contains prediction_key, status, partner_name. Fields by state:

status: "pending" - queued, background job not started. Only the base fields are present; all result fields are null.

status: "processing" - kundalis + Ashtakoota + AI narrative being computed. Result fields still null.

status: "done" - full result: matching_score (out of 36), compatibility_summary, marriage_timing_prediction, koota_breakdown (8 kootas with score/max), person1_manglik, person2_manglik, match_chart_url (Guna Milan table PNG), and user_kundali / partner_kundali (each: name, lagna_sign, moon_sign, moon_nakshatra, north_chart_url, south_chart_url). Note: the partner's chart URLs may be null for a few seconds after done while their chart finishes rendering in a separate job.

status: "failed" - generation errored; prompt the user to retry. Result fields are null.

Errors: 401 - invalid/expired token | 404 - no report with this prediction_key for the current user

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Examples

Done - full resultProcessing - still computingPending - queuedFailed - retry

{
    "success": true,
    "message": "Success",
    "data": {
        "prediction_key": "Match-12345",
        "status": "done",
        "partner_name": "Priya",
        "partner_birth_date": "1996-08-20",
        "matching_score": 28.5,
        "compatibility_summary": "An excellent match \n                                        with strong emotional bonds.",
        "marriage_timing_prediction": "2027 is a highly \n                                        auspicious year for marriage.",
        "koota_breakdown": {
            "Varna": {
                "score": 1,
                "max": 1
            },
            "Vashya": {
                "score": 2,
                "max": 2
            },
            "Tara": {
                "score": 3,
                "max": 3
            },
            "Yoni": {
                "score": 2,
                "max": 4
            },
            "Graha Maitri": {
                "score": 5,
                "max": 5
            },
            "Gana": {
                "score": 6,
                "max": 6
            },
            "Bhakoot": {
                "score": 0,
                "max": 7
            },
            "Nadi": {
                "score": 8,
                "max": 8
            }
        },
        "person1_manglik": false,
        "person2_manglik": true,
        "match_chart_url": "https://cdn.hastaai.in/\n                                        marriage/charts/match-12345.png",
        "user_kundali": {
            "name": "Rahul",
            "lagna_sign": "Aries",
            "moon_sign": "Gemini",
            "moon_nakshatra": "Mrigashira",
            "north_chart_url": "https://cdn.hastaai.in\n                                            /kundali/charts/rahul-north.png",
            "south_chart_url": "https://cdn.hastaai.in\n                                            /kundali/charts/rahul-south.png"
        },
        "partner_kundali": {
            "name": "Priya",
            "lagna_sign": "Leo",
            "moon_sign": "Taurus",
            "moon_nakshatra": "Rohini",
            "north_chart_url": "https://cdn.hastaai.in/\n                                            kundali/charts/priya-north.png",
            "south_chart_url": "https://cdn.hastaai.in/\n                                            kundali/charts/priya-south.png"
        }
    }
}

🟠401Unauthorized

🟠404Record Not Found

🟠422Parameter Error

Get marriage compatibility report

Request

Request Code Samples

Responses