Skip to main content

Example Requests

Use the Unified Add Customer request to onboard an individual customer.

For an example call that you can customize with your information, see the following examples:

Request example for E_KYC​

The following is an example of a request where the KYC mode is E_KYC.

{
    "email": "peter.parker@xyz.com",
    "countryCode": "SG",
    "mobile": "12345678",
    "kycMode": "E_KYC"
}

Request example for E_DOC_VERIFY​

The following is an example of a request where the KYC mode is E_DOC_VERIFY.

{
    "firstName": "Peter",
    "lastName": "Parker",
    "email": "peter.parker@xyz.com",
    "nationality": "IN",
    "countryCode": "SG",
    "mobile": "12345678",
    "dateOfBirth": "1992-12-18",
    "kycMode": "E_DOC_VERIFY",
    "billingAddress1": "123 Long Street",
    "billingAddress2": "Great Lake",
    "billingCity": "Mumbai",
    "billingZipCode": "400011",
    "billingCountry": "IN",
    "verificationConsent": true
}

Request example for MANUAL_KYC​

The following is an example of a request where the KYC mode is MANUAL_KYC.

{
    "firstName": "Sam",
    "lastName": "John",
    "email": "sam@xyz.com",
    "nationality": "IN",
    "countryCode": "SG",
    "mobile": "12345678",
    "dateOfBirth": "1995-05-24",
    "kycMode": "MANUAL_KYC",
    "billingAddress1": "123 Long Street",
    "billingAddress2": "Great Lake",
    "billingCity": "Mumbai",
    "billingZipCode": "00185",
    "billingCountry": "IN",
    "identificationDoc": [
        {
            "identificationType": "PASSPORT",
            "identificationValue": "P12345",
            "identificationDocIssuanceCountry": "IN",
            "identificationDocExpiry": "04/05/2026",
            "identificationDocument": [
                {
                    "fileName": "passport-front.jpg",
                    "fileType": "image/jpeg",
                    "document": "<<base64 encoded image >>"
                },
                {
                    "fileName": "passport-back.jpg",
                    "fileType": "image/jpeg",
                    "document": "<<base64 encoded image >>"
                }
            ]
        }
    ]
}

Request example for E_DOC_VERIFY with unsupported countries​

The following is an example of a request where the KYC mode is E_DOC_VERIFYand address verification details must be collected manually.

This request is used when the country of residence isn't supported by our adress verification vendor. For more information, see SG Oboarding.

{
    "firstName": "Sam",
    "lastName": "John",
    "email": "sam@xyz.com",
    "nationality": "IN",
    "countryCode": "SG",
    "mobile": "12345678",
    "dateOfBirth": "1995-05-24",
    "kycMode": "E_DOC_VERIFY",
    "billingAddress1": "123 Long Street",
    "billingAddress2": "Great Lake",
    "billingCity": "Mumbai",
    "billingZipCode": "00185",
    "billingCountry": "IN",
    "identificationDoc": [
        {
            "identificationType": "PASSPORT",
            "identificationValue": "P12345",
            "identificationDocIssuanceCountry": "IN",
            "identificationDocExpiry": "04/05/2026",
            "identificationDocument": [
                {
                    "fileName": "passport-front.jpg",
                    "fileType": "image/jpeg",
                    "document": "<<base64 encoded image >>"
                },
                {
                    "fileName": "passport-back.jpg",
                    "fileType": "image/jpeg",
                    "document": "<<base64 encoded image >>"
                }
            ]
        }
    ]
}