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"
]
}
}
Updated about 4 hours ago