AML Search

Endpoint Overview

POST /api/v1/aml/aml-search

Description

This API endpoint performs comprehensive Anti-Money Laundering (AML) and Politically Exposed Person (PEP) screening by searching global databases using an individual's personal information. It analyzes the provided details against multiple international watchlists and returns potential matches with associated risk scores and detailed profile information for compliance verification.

Key Benefits

Real-time screening against global AML/PEP databases

Detailed match scoring with confidence levels

Comprehensive profile information including positions, affiliations, and risk factors

Multi-language name matching capabilities

Use Cases

Financial Services

Corporate Compliance

Government

Customer onboarding KYC verification

Transaction monitoring and risk assessment

Regulatory compliance checks for new accounts

Technical Implementation

Authentication

All API requests require authentication using a JWT Bearer token. Authentication follows these steps:

Obtain API Credentials: Register with Surepass to receive your API key.

Generate JWT Token: Use your API key to generate a JWT token.

Include in Requests: Add the token to the Authorization header as Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.io

Production: https://kyc-api.surepass.io

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token authentication using JWT
Content-Type	Yes	application/json

Request Body

Parameter	Type	Required	Description
name	string	Yes	Full name of the person to screen
dob	string	Yes	Date of birth in YYYY-MM-DD format
nationality	string	Yes	Nationality of the person
address	string	Yes	Current residential address

Example Request

{
    "name": "narendra modi",
    "dob": "1950-09-17",
    "nationality": "indian",
    "address": "gujrat"
}

Process Response

Response Parameters

Parameter	Type	Description
data.client_id	string	Unique identifier for the search request
data.name	string	Name used for the search
data.results[].score	number	Match confidence score (0-1)
data.results[].name	array	Known name variations
data.results[].first_name	array	First names of the matched person
data.results[].last_name	array	Last names of the matched person
data.results[].nationality	array	Associated nationalities
data.results[].position	array	Current and past positions held
data.results[].date_of_birth	array	Known date(s) of birth
data.results[].country	array	Associated countries
data.results[].gender	array	Gender(s) of the person
data.results[].email	array	Known email addresses
data.results[].notes	array/string	Additional relevant information
data.results[].birth_place	array	Known place(s) of birth
data.results[].education	array	Education details
data.results[].tax_number	string	Tax identification number
status_code	number	HTTP status code
success	boolean	Indicates if request was successful
message	string	Status message
message_code	string	Message code

Example Successful Response

{
    "data": {
        "client_id": "pep_match_QrNllNSjVxmGkFVtgkol",
        "name": "narendra modi",
        "results": [
            {
                "score": 0.98,
                "name": [
                    "Narendra Modi",
                    "Modi, Shri Narendra"
                ],
                "first_name": [
                    "Narendra"
                ],
                "last_name": [
                    "Modi"
                ],
                "nationality": [
                    "in"
                ],
                "position": [
                    "Lok Sabha (member, 2014-)"
                ],
                "date_of_birth": [
                    "1950-09-17"
                ],
                "country": [
                    "in"
                ],
                "gender": [
                    "male"
                ],
                "email": [
                    "appt.pmo@gov.in"
                ],
                "notes": null,
                "birth_place": null,
                "education": null,
                "tax_number": null
            },
            {
                "score": 0.98,
                "name": [
                    "နရေန္ဒြ မောဒီ",
                    "ناريندرا مودي",
                    "Նարենդրա Մոդի",
                    "Narendra Modi",
                    "Нарэндра Модзі",
                    "নরেন্দ্র মোদী",
                    "ណារិនដ្រាម៉ូឌី",
                    "Narēndra Modi"
                ],
                "first_name": [
                    "Damodar",
                    "Narendra"
                ],
                "last_name": [
                    "Modi"
                ],
                "nationality": [
                    "in"
                ],
                "position": [
                    "Leader of the House in Lok Sabha (2019-)",
                    "Member of the Gujarat Legislative Assembly (2002-2014)",
                    "Minister of Personnel, Public Grievances, & Pensions",
                    "member of the Lok Sabha (2024-)",
                    "Chief Minister of Gujarat (2001-2014)",
                    "Member of the 17th Lok Sabha (2019-)",
                    "Minister of Personnel, Public Grievances and Pensions (2014-)",
                    "Prime Minister of India (2014-)",
                    "Head, Dept. of Space",
                    "Prime Minister",
                    "Head, Dept. of Atomic Energy",
                    "Lok Sabha (member, 2014-)",
                    "Member of the 16th Lok Sabha (2014-)"
                ],
                "date_of_birth": [
                    "1950-09-17"
                ],
                "country": [
                    "in"
                ],
                "gender": [
                    "male"
                ],
                "email": [
                    "appt.pmo@gov.in"
                ],
                "notes": [
                    "14th Prime Minister of India"
                ],
                "birth_place": [
                    "Vadnagar"
                ],
                "education": [
                    "Gujarat University (-1983)",
                    "University of Delhi (-1978)"
                ],
                "tax_number": null
            }
        ]
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Authentication Error

Empty Name

Server Error

{
    "status_code": 401,
    "success": false,
    "message": "Invalid authentication token",
    "message_code": "unauthorized"
}

Integration Best Practices

Security Recommendations

Store API credentials securely and never expose them in client-side code

Implement proper error handling for failed API calls

Use HTTPS for all API communications

Regularly rotate authentication tokens

User Experience Guidelines

Implement proper loading states while waiting for API response

Display match scores prominently to highlight confidence levels

Present multiple matches in an easily scannable format

Include clear error messages for end users

Code Samples

cURL

Python

Node.js

Related APIs

KYC Verification API - Verify identity documents

Document Authentication API - Validate official documents

Face Match API - Biometric verification

Compliance and Legal Considerations

This API helps organizations comply with AML regulations and KYC requirements. Users must ensure they have proper consent for screening individuals and handle the returned data in accordance with relevant privacy laws and data protection regulations.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/aml/aml-search' \ --header 'Content-Type: application/json' \ --data-raw '{ "name": "narendra modi", "dob": "1950-09-17", "nationality": "indian", "address": "gujrat" }'

{ "data": { "client_id": "pep_match_QrNllNSjVxmGkFVtgkol", "name": "narendra modi", "results": [ { "score": 0.98, "name": [ "Narendra Modi", "Modi, Shri Narendra" ], "first_name": [ "Narendra" ], "last_name": [ "Modi" ], "nationality": [ "in" ], "position": [ "Lok Sabha (member, 2014-)" ], "date_of_birth": [ "1950-09-17" ], "country": [ "in" ], "gender": [ "male" ], "email": [ "appt.pmo@gov.in" ], "notes": null, "birth_place": null, "education": null, "tax_number": null }, { "score": 0.98, "name": [ "နရေန္ဒြ မောဒီ", "ناريندرا مودي", "Նարենդրա Մոդի", "Narendra Modi", "Нарэндра Модзі", "নরেন্দ্র মোদী", "ណារិនដ្រាម៉ូឌី", "Narēndra Modi" ], "first_name": [ "Damodar", "Narendra" ], "last_name": [ "Modi" ], "nationality": [ "in" ], "position": [ "Leader of the House in Lok Sabha (2019-)", "Member of the Gujarat Legislative Assembly (2002-2014)", "Minister of Personnel, Public Grievances, & Pensions", "member of the Lok Sabha (2024-)", "Chief Minister of Gujarat (2001-2014)", "Member of the 17th Lok Sabha (2019-)", "Minister of Personnel, Public Grievances and Pensions (2014-)", "Prime Minister of India (2014-)", "Head, Dept. of Space", "Prime Minister", "Head, Dept. of Atomic Energy", "Lok Sabha (member, 2014-)", "Member of the 16th Lok Sabha (2014-)" ], "date_of_birth": [ "1950-09-17" ], "country": [ "in" ], "gender": [ "male" ], "email": [ "appt.pmo@gov.in" ], "notes": [ "14th Prime Minister of India" ], "birth_place": [ "Vadnagar" ], "education": [ "Gujarat University (-1983)", "University of Delhi (-1978)" ], "tax_number": null } ] }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

AML Search

AML Search#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

AML Search

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples