Get Individual Monitor Record Matches

This endpoint will fetch all the matches for a given individual monitor record.

Version 1

GEThttps://okaydbdemo.innov8tif.com/ekyc/api/aml/v3/worklists/{worklistId} /individuals/{monitorRecordId}/matches?apiKey={apiKey}

URL Parameters

Field	Remark
worklistId *	The ID of the worklist where the individual record exists. Mandatory field
monitorRecordId *	The ID of the individual monitor record to retrieve
apiKey *	apiKey is used for authentication.

Response Body

Field	Remark
status	Indicate API status. Values can be success, error.
messageCode	Provide error details if status is error. Values can be: INVALID_API_KEY – invalid api key. MAPI-001– Resource not found (workflowId or monitorRecordId is not found)
matches	Optional

Sample Response Body

Success

{
    "status": "success",
    "messageCode": null,
    "message": null,
    "matches": [
        {
            "currentStatus": "open",
            "qrCode": 3919221,
            "version": 1625579536947,
            "resourceUri": "/individuals/9efdfed542c1cdd5256f9ec484db2a1a93e38e494d840ab9c663936537f84754",
            "resourceId": "9efdfed542c1cdd5256f9ec484db2a1a93e38e494d840ab9c663936537f84754",
            "score": 86,
            "match": "Ahmad Hassan Batal",
            "name": "Ahmad Hassan Batal",
            "addresses": [
                {
                    "geography": "SY",
                    "city": null
                },
                {
                    "geography": "SA",
                    "city": "Jeddah"
                }
            ],
            "datesOfBirth": [
                "1969"
            ],
            "gender": "male",
            "profileImage": "https://www.acurisriskintelligence.com/cdn/content/0020260000/0020255904.jpg",
            "datasets": [
                "PEP-CURRENT"
            ],
            "matchVersion": 10,
            "countries": [
                "SY",
                "SA"
            ],
            "pepTier": "PEP Tier 1",
            "lastReviewDateTimeISO": "2025-11-13T09:28:28.228Z",
            "lastReviewDescription": "Reopened by benjamin.zwahlen",
            "currentSanBodyIds": [],
            "formerSanBodyIds": []
        }
    ],
    "nextToken": null
}