List marriage report history

Request: No body - auth token only. Query page (default 1) and optional report_kind (marriage | compatibility). Omit report_kind to get BOTH kinds together for this user's token, newest first - pass it to filter to just one.

Paginated history of the user's reports (newest first), across both family-member and inline partners. Each item already includes partner_name regardless of report_kind.

Success: 200 - data.reports[] (each: prediction_key, status, partner_name, partner_birth_date, matching_score, positivity_score, report_kind, created_at) plus data.total, data.page, data.limit. Empty array if no reports. Fetch a full result via GET /marriage/report/{prediction_key}.

Errors: 401 invalid/missing token | 404 user not found.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Success",
    "data": {
        "reports": [
            {
                "prediction_key": "Match-12345",
                "status": "done",
                "partner_name": "Priya",
                "partner_birth_date": "1996-08-20",
                "matching_score": 28.5,
                "positivity_score": 79,
                "report_kind": "marriage",
                "created_at": 1717939200000
            },
            {
                "prediction_key": "Match-67890",
                "status": "processing",
                "partner_name": "Riya",
                "partner_birth_date": "1995-02-11",
                "report_kind": "compatibility",
                "created_at": 1717852800000
            }
        ],
        "total": 2,
        "page": 1,
        "limit": 10
    }
}

🟠401Unauthorized

🟠404Record Not Found

🟠422Parameter Error

List marriage report history

Request

Request Code Samples

Responses