NZ Request Examples

To onboard your entity, you can call the Onboard Corporate Customer API. For an example call that you can customize with your information, see:

Private companies

The following is an API request example call where businessType = PRIVATE_COMPANY.

{
    "region": "NZ",
    "businessDetails": {
        "businessName": "Company3",
        "businessType": "PRIVATE_COMPANY",
        "businessRegistrationNumber": "8050675678761",
        "tradeName": "ABCD XYZ",
        "hasNominee": true,
        "isCashIntensiveBusiness": true,
        "bankAccountDetails": {
            "accountName": "Name",
            "bankName": "Bank of Shanghai (Hong Kong) Limited",
            "accountNumber": "77989",
            "currency": "NZD",
            "routingType": "SWIFT",
            "routingValue": "BKNZNZ22",
            "routingType2": "BRANCH CODE",
            "routingValue2": "0797",
            "bankAccountType": "Saving"
        },
        "website": "www.abcdxyz.com",
        "legalDetails": {
            "isRegistered": true,
            "registeredCountry": "NZ",
            "registeredDate": "2000-01-02"
        },
        "addresses": {
            "registeredAddress": {
                "addressLine1": "1,1, abcabc",
                "addressLine2": "Avenue,NIRIMBA",
                "city": "Sydney",
                "state": "QLD",
                "country": "SG",
                "postcode": "2055"
            },
            "businessAddress": {
                "addressLine1": "1,1, abcabc",
                "addressLine2": "Avenue,NIRIMBA",
                "city": "Sydney",
                "state": "QLD",
                "country": "SG",
                "postcode": "2001"
            }
        },
        "stakeholders": [
            {
                "stakeholderDetails": {
                    "kycMode": "MANUAL_KYC",
                    "firstName": "check",
                    "middleName": "ok",
                    "lastName": "Singha",
                    "gender": "Male",
                    "dateOfBirth": "1947-02-15",
                    "nationality": "SG",
                    "contactDetails": {
                        "email": "[email protected]",
                        "contactNo": "964144428"
                    },
                    "address": {
                        "addressLine1": "192, 101, High Street",
                        "addressLine2": "ST",
                        "city": "Sydney",
                        "state": "QLD",
                        "country": "AU",
                        "postcode": "2002"
                    },
                    "professionalDetails": [
                        {
                            "position": "Members",
                            "capitalContribution": "NZ008",
                            "hasDistributionRight": true,
                            "votingRights": [
                                "VTR01"
                            ],
                            "interestPercentage": "80",
                            "trusteeClass": "A"
                        }
                    ]

                }
            }
        ],
        "applicantDetails": {
            "kycMode": "E_KYC",
            "firstName": "app",
            "middleName": "ok",
            "lastName": "det",
            "gender": "Male",
            "dateOfBirth": "1992-08-09",
            "nationality": "NZ",
            "professionalDetails": [
                {
                    "position": "Settlor"
                }
            ],
            "contactDetails": {
                "countryCode": "SG",
                "contactNo": "471822328",
                "email": "[email protected]"
            },
                    "address": {
                        "addressLine1": "192, 101, High Street",
                        "addressLine2": "ST",
                        "city": "Sydney",
                        "state": "QLD",
                        "country": "AU",
                        "postcode": "2002"
                    }
        }
    },
    "expectedAccountUsage": {

        "intendedUses": [
            "IU005"
        ]
    },
    "riskAssessmentInfo": {
        "totalEmployees": "Less than or equal 5",
        "industrySector": "Not for Profit Organisations (Government Incentivised entities)",
        "annualTurnover": "NZ008",
        "countryOfOperation": [
            "India",
            "Spain"
        ],
        "travelRestrictedCountry": "yes",
        "restrictedCountries": [
            "Kenya"
        ],
        "ofacLicencePresent": "yes",
        "transactionCountries": [
            "GB",
            "US",
            "SG"
        ]
    }
}

Trusts

The following is an API request example call where businessType = TRUST.

{
    "region": "NZ",
    "businessDetails": {
        "hasNominee": false,
        "isCashIntensiveBusiness": "false",
        "businessName": "Info busines2",
        "businessRegistrationNumber": "1160204642192",
        "businessType": "Trust",
        "website": "www.lfc.com",
        "bankAccountDetails": {
            "accountName": "Namqweqwesde",
            "bankName": "Bank of Shangh(Hong Kong) Limited",
            "accountNumber": "77989",
            "currency": "NZD",
            "routingType": "SWIFT",
            "routingValue": "BKNZNZ32",
            "routingType2": "BRANCH CODE",
            "routingValue2": "0707",
            "bankAccountType": "Saving"
        },
        "documentDetails": [
            {
                "documentType": "TRUST_DEED",
                "documentNumber": "A1111111",
                "documentValue": "A1111111",
                "documentReferenceNumber": "1",
                "documentHolderName": "Blaine Cecil Fabi",
                "documentIssuanceCountry": "NZ",
                "documentExpiryDate": "2025-08-01",
                "document": [
                    {
                        "fileName": "medicare_card",
                        "fileType": "png",
                        "document": "iVBORw0KGgoAAAANSUhEUgAAAOEAAADhCAMAAAAJbSJIAAAAJFBMVEX/////QAAAAADnOQCnIAD19vZSXV7dNgCkpqf1PQDNzs7P0NCe8r63AAAAoUlEQVR4nO3Wiw3DIAwFQGI+Ccn++1ZNM0IpEr2b4D1ZGKcEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMC31FpnRxjqbBHRztkxxjmi5J5LHLODjHLGvr3tcc2OMkgr20dps6OMUSM/DXOsuW5q9KdhX7bh6jNc/x3+wS5d/z9M6bpvmmUneFv9LgUAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+K0XNkoBrhhCyKYAAAAASUVORK5CYII="
                    }
                ]
            }
        ],
        "addresses": {
            "registeredAddress": {
                "addressLine1": "0932 Cole Parkways",
                "addressLine2": "Walsh Overpass",
                "city": "southwales",
                "state": "southwales",
                "postcode": "3434",
                "country": "NZ"
            }
        },
        
        "tradeName": "testdev",
        "legalDetails": {
            "registeredCountry": "NZ",
            "registeredDate": "2021-04-09",
            "listedExchange": "EX098",
            "isRegistered": "false",
            "legislationType": "LT001"
        },
        "regulatoryDetails": {
            "unregulatedTrustType": [
                "NZTT1"
            ]
        },
        "additionalInfo": {
            "isSameBusinessAddress": "Yes"
        },
        "stakeholders": [
            {
                "entityType": "INDIVIDUAL",
                "stakeholderDetails": {
                    "kycMode": "E_KYC",
                    "firstName": "John",
                    "middleName": "ok",
                    "lastName": "Citizen",
                    "gender": "Male",
                    "isResident": "YES",
                    "dateOfBirth": "1994-05-15",
                    "nationality": "NZ",
                    "documentDetails": [
                        {
                            "documentType": "Passport",
                            "documentNumber": "A1111111",
                            "documentValue": "A1111111",
                            "documentReferenceNumber": "1",
                            "documentHolderName": "Blaine Cecil Fabi",
                            "documentIssuanceCountry": "AU",
                            "documentExpiryDate": "2025-08-01",
                            "document": [
                                {
                                    "fileName": "medicare_card",
                                    "fileType": "png",
                                    "document": "iVBORw0KGgoAAAANSUhEUgAAAOEAAADhCAMAAAAJbSJIAAAAJFBMVEX/////QAAAAADnOQCnIAD19vZSXV7dNgCkpqf1PQDNzs7P0NCe8r63AAAAoUlEQVR4nO3Wiw3DIAwFQGI+Ccn++1ZNM0IpEr2b4D1ZGKcEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMC31FpnRxjqbBHRztkxxjmi5J5LHLODjHLGvr3tcc2OMkgr20dps6OMUSM/DXOsuW5q9KdhX7bh6jNc/x3+wS5d/z9M6bpvmmUneFv9LgUAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+K0XNkoBrhhCyKYAAAAASUVORK5CYII="
                                }
                            ]
                        }
                    ],
                    "professionalDetails": [
                        {
                            "position": "TRUSTEE",
                            "sharePercentage": "52.4",
                            "capitalContribution": "NZ008",
                            "hasDistributionRight": false,
                            "votingRights": [
                                "VTR01",
                                "VTR02"
                            ],
                            "interestPercentage": "47.5",
                            "trusteeClass": "A"
                        }
                    ],
                    "contactDetails": {
                        "contactNo": "726-484-1857",
                        "email": "[email protected]"
                    },
                    "address": {
                        "addressLine1": "192, 101, High Street",
                        "addressLine2": "ST",
                        "city": "Sydney",
                        "state": "QLD",
                        "country": "AU",
                        "postcode": "2002"
                    }
                }
            }
            
        ],
        "applicantDetails": {
            "kycMode": "E_KYC",
            "firstName": "Info Stephaneh",
            "middleName": "sathiyesh",
            "lastName": "Runolfssonasd",
            "dateOfBirth": "1996-05-15",
                    "address": {
                        "addressLine1": "192, 101, High Street",
                        "addressLine2": "ST",
                        "city": "Sydney",
                        "state": "QLD",
                        "country": "AU",
                        "postcode": "2002"
                    },
            "documentDetails": [
                {
                    "documentType": "Passport",
                    "documentNumber": "A1111111",
                    "documentValue": "A1111111",
                    "documentReferenceNumber": "1",
                    "documentHolderName": "Blaine Cecil Fabi",
                    "documentIssuanceCountry": "AU",
                    "documentExpiryDate": "2025-08-01",
                    "document": [
                        {
                            "fileName": "medicare_card",
                            "fileType": "png",
                            "document": "iVBORw0KGgoAAAANSUhEUgAAAOEAAADhCAMAAAAJbSJIAAAAJFBMVEX/////QAAAAADnOQCnIAD19vZSXV7dNgCkpqf1PQDNzs7P0NCe8r63AAAAoUlEQVR4nO3Wiw3DIAwFQGI+Ccn++1ZNM0IpEr2b4D1ZGKcEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMC31FpnRxjqbBHRztkxxjmi5J5LHLODjHLGvr3tcc2OMkgr20dps6OMUSM/DXOsuW5q9KdhX7bh6jNc/x3+wS5d/z9M6bpvmmUneFv9LgUAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+K0XNkoBrhhCyKYAAAAASUVORK5CYII="
                        }
                    ]
                },
                {
                    "documentType": "LOA",
                    "documentNumber": "A1111111",
                    "documentValue": "A1111111",
                    "documentReferenceNumber": "1",
                    "documentHolderName": "Blaine Cecil Fabi",
                    "documentIssuanceCountry": "AU",
                    "documentExpiryDate": "2025-08-01",
                    "document": [
                        {
                            "fileName": "medicare_card",
                            "fileType": "png",
                            "document": "iVBORw0KGgoAAAANSUhEUgAAAOEAAADhCAMAAAAJbSJIAAAAJFBMVEX/////QAAAAADnOQCnIAD19vZSXV7dNgCkpqf1PQDNzs7P0NCe8r63AAAAoUlEQVR4nO3Wiw3DIAwFQGI+Ccn++1ZNM0IpEr2b4D1ZGKcEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMC31FpnRxjqbBHRztkxxjmi5J5LHLODjHLGvr3tcc2OMkgr20dps6OMUSM/DXOsuW5q9KdhX7bh6jNc/x3+wS5d/z9M6bpvmmUneFv9LgUAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+K0XNkoBrhhCyKYAAAAASUVORK5CYII="
                        }
                    ]
                }
            ],
            "contactDetails": {
                "email": "[email protected]",
                "contactNo": "834-290-2983",
                "countryCode": "NZ"
            },
            "nationality": "NZ",
                   "professionalDetails": [
                        {
                            "position": "TRUSTEE",
                            "capitalContribution": "NZ008",
                            "hasDistributionRight": true,
                            "votingRights": [
                                "VTR01"
                            ],
                            "interestPercentage": "80",
                            "trusteeClass": "A"
                        }
                    ]
        }
    },
    "riskAssessmentInfo": {
        "totalEmployees": "EM004",
        "annualTurnover": "NZ008",
        "industrySector": "IS002",
        "intendedUseOfAccount": "IU001",
        "countryOfOperation": [
            "ZW"
        ],
        "transactionCountries": [
            "SG"
        ]
    },
    "expectedAccountUsage": {
        "intendedUses": [
            "IU001",
            "IU005",
            "IU010"
        ]
    }
}

Sole Trader

The following is an API request example call where businessType = SOLE_TRADER.

{
    "businessDetails": {
        "additionalInfo": {
            "isSameBusinessAddress": "Yes"
        },
        "addresses": {
            "businessAddress": {
                "addressLine1": "",
                "addressLine2": "",
                "city": "",
                "country": "",
                "postcode": "",
                "state": ""
            },
            "registeredAddress": {
                "addressLine1": "0932 Cole Parkways",
                "addressLine2": "Walsh Overpass",
                "city": "southwales",
                "country": "NZ",
                "postcode": "3434",
                "state": "southwales"
            }
        },
        "applicantDetails": {
            "address": {
                "addressLine1": "192, 101, High Street",
                "addressLine2": "ST",
                "city": "Sydney",
                "state": "QLD",
                "postcode": "3207",
                "country": "AU"
            },
            "contactDetails": {
                "contactNo": "834-290-2983",
                "countryCode": "NZ",
                "email": "[email protected]"
            },
            "dateOfBirth": "1994-05-15",
            "documentDetails": [
                {
                    "document": [
                        {
                            "fileName": "DL.PDF",
                            "fileType": "PDF",
                            "document": "iVBORw0KGgoAAAANSUhEUgAAAOEAAADhCAMAAAAJbSJIAAAAJFBMVEX/////QAAAAADnOQCnIAD19vZSXV7dNgCkpqf1PQDNzs7P0NCe8r63AAAAoUlEQVR4nO3Wiw3DIAwFQGI+Ccn++1ZNM0IpEr2b4D1ZGKcEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMC31FpnRxjqbBHRztkxxjmi5J5LHLODjHLGvr3tcc2OMkgr20dps6OMUSM/DXOsuW5q9KdhX7bh6jNc/x3+wS5d/z9M6bpvmmUneFv9LgUAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+K0XNkoBrhhCyKYAAAAASUVORK5CYII="
                        }
                    ],
                    "documentExpiryDate": "2035-01-01",
                    "documentIssuanceCountry": "HK",
                    "documentNumber": "781278746",
                    "documentReferenceNumber": "DL09327",
                    "documentType": "Passport"
                }
            ],
            "firstName": "Stephan",
            "kycMode": "E_KYC",
            "lastName": "Ondricka",
            "middleName": "sathiyesh",
            "nationality": "NZ",
            "professionalDetails": [
                {
                    "position": "Director",
                    "sharePercentage": "40"
                }
            ]
        },
        "businessName": "Kuhlman GroupLittel-Cole",
        "businessRegistrationNumber": "7796568638548",
        "businessType": "SOLE_TRADER",
        "hasNominee": true,
        "isCashIntensiveBusiness": true,
        "bankAccountDetails": {
            "accountName": "Name",
            "bankName": "Bank of Shanghai (Hong Kong) Limited",
            "accountNumber": "77989",
            "currency": "NZD",
            "routingType": "SWIFT",
            "routingValue": "BKNZNZ22",
            "routingType2": "BRANCH CODE",
            "routingValue2": "0797",
            "bankAccountType": "Saving"
        },
        "legalDetails": {
            "legislationType": "LT001",
            "listedExchange": "EX098",
            "registeredCountry": "NZ",
            "registeredDate": "2021-04-09",
            "isRegistered": true
        },
        "stakeholders": [
            {
                "entityType": "INDIVIDUAL",
                "stakeholderDetails": {
            "address": {
                "addressLine1": "192, 101, High Street",
                "addressLine2": "ST",
                "city": "Sydney",
                "state": "QLD",
                "postcode": "3207",
                "country": "AU"
            },
                    "contactDetails": {
                        "contactNo": "726-484-1857",
                        "countryCode": "NZ",
                        "email": "[email protected]"
                    },
                    "dateOfBirth": "1994-07-02",
                    "documentDetails": [
                        {
                            "document": [
                                {
                                    "fileName": "DL.PDF",
                                    "fileType": "PDF",
                                    "document": "iVBORw0KGgoAAAANSUhEUgAAAOEAAADhCAMAAAAJbSJIAAAAJFBMVEX/////QAAAAADnOQCnIAD19vZSXV7dNgCkpqf1PQDNzs7P0NCe8r63AAAAoUlEQVR4nO3Wiw3DIAwFQGI+Ccn++1ZNM0IpEr2b4D1ZGKcEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMC31FpnRxjqbBHRztkxxjmi5J5LHLODjHLGvr3tcc2OMkgr20dps6OMUSM/DXOsuW5q9KdhX7bh6jNc/x3+wS5d/z9M6bpvmmUneFv9LgUAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+K0XNkoBrhhCyKYAAAAASUVORK5CYII="
                                }
                            ],
                            "documentExpiryDate": "2035-01-01",
                            "documentIssuanceCountry": "HK",
                            "documentNumber": "781278746",
                            "documentReferenceNumber": "DL09327",
                            "documentType": "Passport"
                        }
                    ],
                    "firstName": "Michael",
                    "kycMode": "E_KYC",
                    "lastName": "Kuvalis",
                    "middleName": "test",
                    "nationality": "NZ",
                    "professionalDetails": [
                        {
                            "position": "PARTNER",
                            "capitalContribution": "NZ009",
                            "hasDistributionRight": false,
                            "votingRights": [
                                "VTR01"
                            ],
                            "interestPercentage": "37.5",
                            "trusteeClass": "B",
                            "sharePercentage": "80"
                        }
                    ]
                }
            }
        ]
    },
    "region": "NZ",
    "riskAssessmentInfo": {
        "totalEmployees": "EM001",
        "annualTurnover": "NZ008",
        "industrySector": "IS001",
        "countryOfOperation": [
            "AU"
        ],
        "transactionCountries": [
            "AU"
        ]
    },
    "expectedAccountUsage": {

        "intendedUses": [
            "IU005"
        ]
    }
}