Get marriage compatibility report

Request: No body - auth token only. Path prediction_key (Match-XXXXX).

Poll after POST /marriage/report. Always returns HTTP 200 with a status field; poll until status is done or failed.

Success: 200 - body always contains prediction_key, status, partner_name, partner_birth_date, report_kind. The whole generated payload nests under the single report_data object - populated when status is done, null otherwise, so check one field instead of many. When done, report_data always contains: matching_score (out of 36), compatibility_summary, koota_breakdown (8 kootas with score/max), person1_manglik, person2_manglik, confidence, positivity_score, charts[] (the shareable Guna Milan match card), report_envelope (headline_score/score_label/verdict/highlights/strengths/challenges+solutions), and user_kundali/partner_kundali names.

report_kind: marriage ONLY additionally includes: marriage_timing_prediction, narration_url (audio), charts[] also carries both partners' North+South Rashi charts (each with a plain-language label), report_envelope.life_areas + .technical_detail + .pending, and partner_kundali gains lagna_sign/moon_sign/moon_nakshatra. report_kind: compatibility returns null/omits all of these - that gap is the paid upgrade. Some partner charts may appear a few seconds after done while a separate render job finishes.

States: pending / processing (report_data null) | done (report_data populated) | failed (errored - prompt retry).

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

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

application/json

Successful Response

Bodyapplication/json

Examples

Done - report_kind: marriage (full result)Done - report_kind: compatibility (gated result)Processing - still computingPending - queuedFailed - retry

{
    "success": true,
    "message": "Success",
    "data": {
        "prediction_key": "Match-12345",
        "status": "done",
        "partner_name": "Priya",
        "partner_birth_date": "1996-08-20",
        "report_kind": "marriage",
        "report_data": {
            "matching_score": 28.5,
            "compatibility_summary": "An excellent match with strong emotional bonds.",
            "marriage_timing_prediction": "2027 is a highly auspicious year.",
            "koota_breakdown": {
                "varna": {
                    "score": 1,
                    "max": 1
                }
            },
            "person1_manglik": false,
            "person2_manglik": false,
            "confidence": "precise",
            "positivity_score": 79,
            "narration_url": "https://images.hastaai.in/narrations/match-12345.mp3",
            "charts": [
                {
                    "chart_type": "guna_milan",
                    "image_url": "https://images.hastaai.in/charts/match.webp",
                    "label": "Guna Milan Match"
                },
                {
                    "subject": "self",
                    "chart_type": "rashi",
                    "style": "north",
                    "image_url": "https://images.hastaai.in/charts/rahul-n.webp",
                    "label": "Rahul - Birth Chart (North Indian)"
                }
            ],
            "report_envelope": {
                "headline_score": 82,
                "score_label": "Strongly favourable",
                "verdict": "You are entering a warm, opportunity-rich phase - lead with your natural confidence and good things follow.",
                "highlights": [
                    "A standout year for career visibility",
                    "Deep, loyal relationships get stronger",
                    "Your health and energy are on the rise"
                ],
                "strengths": [
                    {
                        "title": "Natural communicator",
                        "text": "You put people at ease and explain ideas simply - a gift that opens doors in work and friendships."
                    }
                ],
                "challenges": [
                    {
                        "title": "You take on too much",
                        "text": "Your drive is real, but saying yes to everything can leave you drained.",
                        "solution": "Pick one priority each morning and protect it. Small, steady focus beats scattered effort."
                    }
                ],
                "life_areas": [
                    {
                        "area": "Career",
                        "text": "A strong year for visibility - say yes to the project that scares you a little."
                    }
                ],
                "technical_detail": "Lagna in Cancer with Moon in Rohini nakshatra; current Jupiter Mahadasha supports growth in the 10th house of career. Manglik dosha is absent.",
                "technical_breakdown": [
                    {
                        "heading": "House-by-House Breakdown",
                        "points": [
                            "1st House - Sagittarius (Moon): an emotional, truth-seeking nature with a restless energy that keeps pushing you to learn.",
                            "2nd House - Capricorn (Sun, Mercury retrograde): disciplined focus on wealth-building, though retrograde Mercury can delay financial decisions."
                        ]
                    }
                ],
                "confidence": "precise",
                "pending": []
            },
            "user_kundali": {
                "name": "Rahul",
                "lagna_sign": "Sagittarius",
                "moon_sign": "Sagittarius",
                "moon_nakshatra": "Mula"
            },
            "partner_kundali": {
                "name": "Priya",
                "lagna_sign": "Leo",
                "moon_sign": "Taurus",
                "moon_nakshatra": "Rohini"
            }
        }
    }
}

Get marriage compatibility report

Request

Request Code Samples

Responses