Initiate synchronous dedupe

POST

/party-dedupe

A synchronous deduplication (dedupe) call refers to a process where the system performs a real-time duplicate check during customer creation or existing customer's data update. The system waits for the deduplication result before proceeding. In this type of operation, the deduplication process is integrated into the party onboarding or party update workflow. You can initiate a synchronous dedupe call using this endpoint. The request body consists of party details received from the external system. The system validates the details in this request against the party data existing in the FYNDNA system.

Request

Body Params application/json

Examples

Responses

🟢200OK

*/*

Body

🟠400Bad Request

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://dev.your-api-server.com/party-dedupe' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": "189701551",
    "owningEntityType": "PARTY_ID",
    "owningEntityId": "189001551",
    "partyEventCode": "RE_KYC_UPDATE",
    "partyType": "INDIVIDUAL",
    "dedupeAttribute": {
        "partyType": "INDIVIDUAL",
        "externalReferences": [
            {
                "id": "811_00_9786_78y647q36",
                "dirty": null,
                "deleted": true,
                "externalSystem": "MiRevenue",
                "externalId": "9511115e-af51-43fb-9027-700cfabdffe2",
                "internalReferenceId": "811_00_9786_78y647q36"
            }
        ],
        "phoneNumberDetails": [
            "9916134589"
        ],
        "emailDetails": [
            "balu.singh@abc.com"
        ],
        "fullName": "Yuvraj Singh",
        "dateOfBirth": "01-11-1987",
        "identifications": [
            {
                "id": "096a4789-c624-4a2d-8afa-7a53ac433c13",
                "dirty": true,
                "deleted": true,
                "type": "AADHAAR",
                "value": "690134516213"
            }
        ]
    },
    "onlyConfirmedMatches": true,
    "url": "{{API gateway IP address}}/party-onboarding/party-onboarding/{{dedupe result ID}}/update-dedupe-status"
}'

Response Example

200 - Example 1

Modified at 2025-02-17 09:41:54

Dedupe execution

Initiate asynchronous dedupe