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": "ABCD Corp",
"businessType": "PRIVATE_COMPANY",
"businessRegistrationNumber": "8050775678762",
"tradeName": "AB Company",
"hasNominee": true,
"isCashIntensiveBusiness": true,
"bankAccountDetails":
{
"accountName": "AB Company",
"bankName": "Commonwealth Bank",
"accountNumber": "77989",
"currency": "NZD",
"routingType": "SWIFT",
"routingValue": "BKNZNZ22",
"routingType2": "BRANCH CODE",
"routingValue2": "0797",
"bankAccountType": "Saving"
},
"website": "www.abcdxyz.com",
"legalDetails":
{
"registeredCountry": "NZ",
"registeredDate": "2000-01-02"
},
"addresses":
{
"registeredAddress":
{
"addressLine1": "1,1, abcabc",
"addressLine2": "Avenue,NIRIMBA",
"city": "Wellington",
"state": "QLD",
"country": "NZ",
"postcode": "5016"
},
"businessAddress":
{
"addressLine1": "1,1, abcabc",
"addressLine2": "Avenue,NIRIMBA",
"city": "Wellington",
"state": "QLD",
"country": "NZ",
"postcode": "5016"
}
},
"stakeholders":
[
{
"stakeholderDetails":
{
"kycMode": "MANUAL_KYC",
"firstName": "John",
"middleName": "Conner",
"lastName": "Smith",
"dateOfBirth": "1947-02-15",
"nationality": "SG",
"documentDetails":
[
{
"documentType": "PASSPORT",
"documentNumber": "125710929",
"documentIssuanceCountry": "SG",
"documentExpiryDate": "2031-05-20",
"document":
[
{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "john_passport",
"fileType": "application/pdf"
}
]
}
],
"address":
{
"addressLine1": "192, 101, High Street",
"addressLine2": "ST",
"city": "Sydney",
"state": "QLD",
"country": "AU",
"postcode": "2002"
},
"professionalDetails":
[
{
"position": "UBO",
"sharePercentage": "34.5",
"capitalContribution": "NZ008",
"hasDistributionRight": true,
"votingRights":
[
"VTR01"
]
}
]
}
},
{
"stakeholderDetails":
{
"kycMode": "E_KYC",
"firstName": "Jane",
"middleName": "M",
"lastName": "Doe",
"dateOfBirth": "1972-02-15",
"nationality": "NZ",
"documentDetails":
[
{
"documentType": "DRIVER_LICENCE",
"documentNumber": "125710929",
"documentReferenceNumber": "ACV",
"documentIssuanceCountry": "NZ",
"documentExpiryDate": "2031-05-20"
}
],
"address":
{
"addressLine1": "192, 101, High Street",
"addressLine2": "ST",
"city": "WELLINGTON",
"state": "Arrowtown",
"country": "NZ",
"postcode": "2002"
},
"professionalDetails":
[
{
"position": "DIRECTOR",
}
]
}
}
],
"applicantDetails":
{
"kycMode": "E_KYC",
"firstName": "Terrance",
"middleName": "M",
"lastName": "Smith",
"dateOfBirth": "1972-02-15",
"nationality": "NZ",
"professionalDetails":
[
{
"position": "NOMINEE_SHAREHOLDER" }
],
"contactDetails":
{
"countryCode": "NZ",
"contactNo": "471822328",
"email": "[email protected]"
},
"documentDetails":
[
{
"documentType": "DRIVER_LICENCE",
"documentNumber": "125710929",
"documentReferenceNumber": "ACV",
"documentIssuanceCountry": "SG"
}
],
"address":
{
"addressLine1": "192, 101, High Street",
"addressLine2": "ST",
"city": "Sydney",
"state": "QLD",
"country": "NZ",
"postcode": "2002"
}
}
},
"expectedAccountUsage":
{
"intendedUses":
[
"IU005",
"IU004"
]
},
"riskAssessmentInfo":
{
"totalEmployees": "EM009",
"industrySector": "IS144",
"annualTurnover": "NZ008",
"countryOfOperation":
[
"IN",
"GB"
],
"transactionCountries":
[
"GB",
"US",
"SG"
]
}
}
Trusts
The following is an API request example call where businessType = TRUST.
{
"region": "NZ",
"businessDetails":
{
"businessName": "Good Children Trust",
"businessType": "TRUST",
"businessRegistrationNumber": "8050695628781",
"tradeName": "Aspire Trust",
"hasNominee": false,
"isCashIntensiveBusiness": false,
"documentDetails":
[
{
"documentType": "TRUST_DEED",
"document":
[
{
"fileName": "TrustDeed.png",
"fileType": "png",
"document": "iVBORw0KGgoAAAANSUhEUgAAAOEAAADhCAMAAAAJbSJIAAAAJFBMVEX/////QAAAAADnOQCnIAD19vZSXV7dNgCkpqf1PQDNzs7P0NCe8r63AAAAoUlEQVR4nO3Wiw3DIAwFQGI+Ccn++1ZNM0IpEr2b4D1ZGKcEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMC31FpnRxjqbBHRztkxxjmi5J5LHLODjHLGvr3tcc2OMkgr20dps6OMUSM/DXOsuW5q9KdhX7bh6jNc/x3+wS5d/z9M6bpvmmUneFv9LgUAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+K0XNkoBrhhCyKYAAAAASUVORK5CYII="
}
]
}
],
"bankAccountDetails":
{
"accountName": "Aspire Trust",
"bankName": "Commonwealth Bank",
"accountNumber": "77989",
"currency": "NZD",
"routingType": "SWIFT",
"routingValue": "BKNZNZ22",
"routingType2": "BRANCH CODE",
"routingValue2": "0797",
"bankAccountType": "Saving"
},
"regulatoryDetails":
{
"unregulatedTrustType":
[
"NZTT2"
]
},
"legalDetails":
{
"registeredCountry": "NZ",
"registeredDate": "2002-01-02"
},
"addresses":
{
"registeredAddress":
{
"addressLine1": "1,1, abcabc",
"addressLine2": "Avenue,NIRIMBA",
"city": "Wellington",
"state": "Arrowtown",
"country": "NZ",
"postcode": "5016"
},
"businessAddress":
{
"addressLine1": "1,1, abcabc",
"addressLine2": "Avenue,NIRIMBA",
"city": "Wellington",
"state": "Arrowtown",
"country": "NZ",
"postcode": "5016"
}
},
"stakeholders":
[
{
"stakeholderDetails":
{
"kycMode": "MANUAL_KYC",
"firstName": "John",
"middleName": "Conner",
"lastName": "Smith",
"dateOfBirth": "1947-02-15",
"nationality": "SG",
"documentDetails":
[
{
"documentType": "PASSPORT",
"documentNumber": "125710929",
"documentIssuanceCountry": "SG",
"documentExpiryDate": "2031-05-20",
"document":
[
{
"document": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3Y5AAAADklEQVQI12P4AIX8EAgALgAD/aNpbtEAAAAASUVORK5CYII",
"fileName": "john_passport",
"fileType": "application/pdf"
}
]
}
],
"address":
{
"addressLine1": "192, 101, High Street",
"addressLine2": "ST",
"city": "Sydney",
"state": "QLD",
"country": "AU",
"postcode": "2002"
},
"professionalDetails":
[
{
"position": "TRUSTEE",
"capitalContribution": "NZ008",
"hasDistributionRight": true,
"votingRights":
[
"VTR01"
],
"trustBeneficiaryClass": "A"
}
]
}
},
{
"stakeholderDetails":
{
"kycMode": "E_KYC",
"firstName": "Jane",
"middleName": "M",
"lastName": "Doe",
"dateOfBirth": "1972-02-15",
"nationality": "NZ",
"documentDetails":
[
{
"documentType": "DRIVER_LICENCE",
"documentNumber": "125710929",
"documentReferenceNumber": "ACV",
"documentIssuanceCountry": "SG",
"documentExpiryDate": "2031-05-20"
}
],
"address":
{
"addressLine1": "192, 101, High Street",
"addressLine2": "ST",
"city": "Sydney",
"state": "QLD",
"country": "NZ",
"postcode": "2002"
},
"professionalDetails":
[
{
"votingRights":
[
"VTR01"
],
"position": "SETTELOR",
"capitalContribution": "NZ008",
"hasDistributionRight": true
}
]
}
},
{
"businessPartner":
{
"businessType": "PRIVATE_COMPANY",
"businessRegistrationNumber": "1234567890123",
"businessEntityType": "TRUSTEE",
"businessName": "Ace Group aab",
"capitalContribution": "NZ008",
"legalDetails":
{
"registeredCountry": "NZ",
"registeredDate": "2019-08-10"
}
}
}
],
"applicantDetails":
{
"kycMode": "E_KYC",
"firstName": "Terrance",
"middleName": "M",
"lastName": "Smith",
"dateOfBirth": "1972-02-15",
"nationality": "NZ",
"professionalDetails":
[
{
"position": "DIRECTOR"
}
],
"contactDetails":
{
"countryCode": "NZ",
"contactNo": "471822328",
"email": "[email protected]"
},
"documentDetails":
[
{
"documentType": "DRIVER_LICENCE",
"documentNumber": "125710929",
"documentReferenceNumber": "ACV",
"documentIssuanceCountry": "SG",
"documentExpiryDate": "2031-05-20"
}
],
"address":
{
"addressLine1": "192, 101, High Street",
"addressLine2": "ST",
"city": "Wellington",
"state": "Arrowtown",
"country": "NZ",
"postcode": "2002"
}
}
},
"expectedAccountUsage":
{
"intendedUses":
[
"IU005",
"IU004"
]
},
"riskAssessmentInfo":
{
"totalEmployees": "EM009",
"industrySector": "IS144",
"annualTurnover": "NZ008",
"countryOfOperation":
[
"IN",
"GB"
],
"transactionCountries":
[
"GB",
"US",
"SG"
]
}
}
Sole Trader
The following is an API request example call where businessType = SOLE_TRADER.
{
"region": "NZ",
"businessDetails":
{
"businessName": "Jack Enterprises",
"businessType": "SOLE_TRADER",
"businessRegistrationNumber": "8050675678761",
"hasNominee": false,
"isCashIntensiveBusiness": true,
"bankAccountDetails":
{
"accountName": "Jack Smith",
"bankName": "Commonwealth Bank",
"accountNumber": "77989",
"currency": "NZD",
"routingType": "SWIFT",
"routingValue": "BKNZNZ22",
"routingType2": "BRANCH CODE",
"routingValue2": "0797",
"bankAccountType": "Saving"
},
"legalDetails":
{
"registeredCountry": "NZ",
"registeredDate": "2002-01-02"
},
"addresses":
{
"registeredAddress":
{
"addressLine1": "1,1, abcabc",
"addressLine2": "Avenue,NIRIMBA",
"city": "Wellington",
"state": "QLD",
"country": "NZ",
"postcode": "5016"
},
"businessAddress":
{
"addressLine1": "1,1, abcabc",
"addressLine2": "Avenue,NIRIMBA",
"city": "Wellington",
"state": "QLD",
"country": "NZ",
"postcode": "5016"
}
},
"stakeholders":
[
{
"stakeholderDetails":
{
"kycMode": "E_KYC",
"firstName": "Jack",
"middleName": "M",
"lastName": "Smith",
"dateOfBirth": "1972-02-15",
"nationality": "NZ",
"documentDetails":
[
{
"documentType": "DRIVER_LICENCE",
"documentNumber": "125710929",
"documentReferenceNumber": "ACV",
"documentIssuanceCountry": "SG",
"documentExpiryDate": "2031-05-20"
}
],
"address":
{
"addressLine1": "192, 101, High Street",
"addressLine2": "ST",
"city": "Sydney",
"state": "QLD",
"country": "NZ",
"postcode": "2002"
},
"professionalDetails":
[
{
"position": "UBO",
"capitalContribution": "NZ008",
"hasDistributionRight": true,
"votingRights":
[
"VTR01"
]
}
]
}
}
],
"applicantDetails":
{
"kycMode": "E_KYC",
"firstName": "Jack",
"middleName": "M",
"lastName": "Smith",
"dateOfBirth": "1972-02-15",
"nationality": "NZ",
"professionalDetails":
[
{
"position": "UBO",
"capitalContribution": "NZ008",
"hasDistributionRight": true,
"votingRights":
[
"VTR01"
]
}
],
"contactDetails":
{
"countryCode": "NZ",
"contactNo": "471822328",
"email": "[email protected]"
},
"documentDetails":
[
{
"documentType": "DRIVING_LICENCE",
"documentNumber": "125710929",
"documentReferenceNumber": "ACV",
"documentIssuanceCountry": "SG",
"documentExpiryDate": "2031-05-20"
}
],
"address":
{
"addressLine1": "192, 101, High Street",
"addressLine2": "ST",
"city": "Willington",
"state": "Arrowtown",
"country": "NZ",
"postcode": "2002"
}
}
},
"expectedAccountUsage":
{
"intendedUses":
[
"IU005",
"IU003"
]
},
"riskAssessmentInfo":
{
"totalEmployees": "EM009",
"industrySector": "IS144",
"annualTurnover": "NZ008",
"countryOfOperation":
[
"IN",
"ES"
],
"transactionCountries":
[
"GB",
"US",
"SG"
]
}
}
Updated 25 days ago