SG Request Examples

Suggest Edits

To onboard your individual customer, call the Unified Add Customer endpoint.

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

Request example for E_KYC

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

{
    "email": "[email protected]",
    "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": "[email protected]",
    "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": "[email protected]",
    "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": "[email protected]",
    "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 >>"
                }
            ]
        }
    ]
}

Updated 1 day ago