EU 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": "EU",
"businessDetails": {
"businessName": "KOLBE ELECTRIC COMPANY21",
"businessRegistrationNumber": "32000008293",
"businessType": "PRIVATE_COMPANY",
"tradeName": "Kolbe Electric",
"website": "www.kolbe.com",
"legalDetails": {
"registeredCountry": "DE",
"registeredDate": "2018-11-12"
},
"addresses": {
"registeredAddress": {
"addressLine1": "Güntzelstrasse 99",
"city": "Mehring",
"state": "Freistaat Bayern",
"country": "DE",
"postcode": "84561"
}
},
"taxDetails": [
{
"country": "DE",
"taxNumber": "12223423"
}
],
"documentDetails": [
{
"documentType": "BUSINESS_REGISTRATION_DOC",
"document": [
{
"fileName": "BRD",
"fileType": "application/pdf",
"document": "JVBERi0xLjcNCiW1tbW1DQoxIDAgb2KL6y9mB9Y8hV46zH/mx0B52ekL8a01ftDTZUi1XyWkN9PsDj"
}
]
},
{
"documentType": "REGISTER_OF_DIRECTORS",
"document": [
{
"fileName": "RegisterOfDirectors",
"fileType": "application/pdf",
"document": "JVBERi0xLjcNCiW1tbW1DQoxIDAgb2JqDQo8PC98hV46zH/mx0B52ekL8a01ftDTZUi1XyWkN9PsDj"
}
]
},
{
"documentType": "REGISTER_OF_SHAREHOLDERS",
"document": [
{
"fileName": "RegisterOfShareholders",
"fileType": "application/pdf",
"document": "JVBERi0xLjcNCiW1tbW1DQoxIDAgb2JqDQo8PC98hV46zH/mx0B52ekL8a01ftDTZUi1XyWkN9PsDj"
}
]
}
],
"stakeholders": [
{
"referenceId": "29aeb27f-4168-4125-a3b0-fa786f425a7c",
"businessPartner": {
"businessName": "NEWVILE INC.",
"businessRegistrationNumber": "900843822",
"businessEntityType": "SHAREHOLDER",
"addresses": {
"registeredAddress": {
"addressLine1": "Güntzelstrasse 99",
"city": "Mehring",
"state": "Freistaat Bayern",
"country": "DE",
"postcode": "84561"
}
},
"legalDetails": {
"registeredCountry": "DE"
},
"sharePercentage": "05.00"
}
},
{
"stakeholderDetails": {
"firstName": "KATIE",
"middleName": "ATIKINSON",
"lastName": "RONTAK",
"nationality": "GB",
"dateOfBirth": "1981-06-15",
"address": {
"addressLine1": "13 Hursley Road Chandlers Ford",
"city": "Eastleigh",
"state": "London",
"country": "GB",
"postcode": "SO53 2FW"
},
"professionalDetails": [
{
"position": "DIRECTOR"
}
],
"taxDetails": [
{
"country": "DE",
"taxNumber": "12223423"
}
],
"additionalInfo": {
"isPep": "No"
},
"documentDetails": [
{
"documentType": "PASSPORT",
"documentNumber": "Z3367529",
"documentIssuanceCountry": "GB",
"documentExpiryDate": "2026-01-04"
}
]
}
}
],
"applicantDetails": {
"firstName": "SHELDON",
"middleName": "PATTERSON",
"lastName": "COOPER",
"nationality": "DE",
"dateOfBirth": "1981-06-15",
"address": {
"addressLine1": "Güntzelstrasse 99",
"city": "Mehring",
"state": "Freistaat Bayern",
"country": "DE",
"postcode": "84561"
},
"contactDetails": {
"contactNo": "8897681220",
"email": "[email protected]",
"countryCode": "DE"
},
"professionalDetails": [
{
"position": "DIRECTOR"
}
],
"kycMode": "E_DOC_VERIFY",
"birthCountry": "DE",
"additionalInfo": {
"isPep": "No"
},
"documentDetails": [
{
"documentType": "PASSPORT",
"documentNumber": "Z3367659",
"documentIssuanceCountry": "SG",
"documentExpiryDate": "2026-01-04"
}
]
},
"additionalInfo": {
"searchId": "e23e8883-a58c-4003-adb3-41e31bc57282",
"isSameBusinessAddress": "Yes"
}
},
"riskAssessmentInfo": {
"totalEmployees": "EM005",
"annualTurnover": "EU001",
"industrySector": "IS053",
"intendedUseOfAccount": "IU004",
"countryOfOperation": [
"DE"
],
"transactionCountries": [
"US",
"AU",
"DE"
]
},
"tags": [
{
"key": "Tag 1",
"value": "Tag value 1"
},
{
"key": "Tag 2",
"value": "Tag value 2"
}
]
}
Trusts
The following is an API request example call where businessType = TRUST.
{
"region": "EU",
"businessDetails": {
"businessName": "BELGIUM ROTARY TRUST21",
"businessRegistrationNumber": "3200000318176",
"businessType": "TRUST",
"website": "www.belgiumrotary.com",
"legalDetails": {
"registeredCountry": "DE",
"registeredDate": "2018-11-12"
},
"addresses": {
"registeredAddress": {
"addressLine1": "Güntzelstrasse 99",
"city": "Mehring",
"state": "Freistaat Bayern",
"country": "DE",
"postcode": "84561"
}
},
"taxDetails": [
{
"country": "DE",
"taxNumber": "12223423"
}
],
"documentDetails": [
{
"documentType": "TRUST_DEED",
"document": [
{
"fileName": "TrustDeed",
"fileType": "application/pdf",
"document": "<Base64 document>JVBERi0xLjcNCiW18tgNoRVi36EkkuwKL6y9mB9Y8hV46zH/mx0B52ekL8a01ftDTZUi1XyWkN9PsDj"
}
]
}
],
"stakeholders": [
{
"referenceId": "29aeb27f-4168-4125-a3b0-fa786f425a7c",
"businessPartner": {
"businessName": "LUMINOS INC.",
"businessRegistrationNumber": "900843822",
"businessEntityType": "SHAREHOLDER",
"addresses": {
"registeredAddress": {
"addressLine1": "Güntzelstrasse 99",
"city": "Mehring",
"state": "Freistaat Bayern",
"country": "DE",
"postcode": "84561"
}
},
"legalDetails": {
"registeredCountry": "DE"
},
"sharePercentage": "05.00"
}
},
{
"stakeholderDetails": {
"firstName": "KATIE",
"middleName": "JONATHAN",
"lastName": "ATKINSON",
"nationality": "GB",
"dateOfBirth": "1981-06-15",
"address": {
"addressLine1": "13 Hursley Road Chandlers Ford",
"city": "Eastleigh",
"state": "London",
"country": "GB",
"postcode": "SO53 2FW"
},
"professionalDetails": [
{
"position": "DIRECTOR"
}
],
"taxDetails": [
{
"country": "DE",
"taxNumber": "12223423"
}
],
"additionalInfo": {
"isPep": "No"
},
"documentDetails": [
{
"documentType": "PASSPORT",
"documentNumber": "Z3367529",
"documentIssuanceCountry": "GB",
"documentExpiryDate": "2026-01-04"
}
]
}
}
],
"applicantDetails": {
"firstName": "JOHN",
"middleName": "PATTERSON",
"lastName": "KOLEMAN",
"nationality": "DE",
"dateOfBirth": "1981-06-15",
"address": {
"addressLine1": "Güntzelstrasse 99",
"city": "Mehring",
"state": "Freistaat Bayern",
"country": "DE",
"postcode": "84561"
},
"contactDetails": {
"contactNo": "8897681220",
"email": "[email protected]",
"countryCode": "DE"
},
"professionalDetails": [
{
"position": "DIRECTOR"
}
],
"kycMode": "E_DOC_VERIFY",
"birthCountry": "DE",
"additionalInfo": {
"isPep": "No"
},
"documentDetails": [
{
"documentType": "PASSPORT",
"documentNumber": "Z3367659",
"documentIssuanceCountry": "SG",
"documentExpiryDate": "2026-01-04"
}
]
},
"additionalInfo": {
"searchId": "e23e8883-a58c-4003-adb3-41e31bc57282",
"isSameBusinessAddress": "Yes"
}
},
"riskAssessmentInfo": {
"totalEmployees": "EM003",
"annualTurnover": "EU001",
"industrySector": "IS053",
"intendedUseOfAccount": "IU004",
"countryOfOperation": [
"DE"
],
"transactionCountries": [
"US",
"AU",
"DE"
]
},
"tags": [
{
"key": "Tag 1",
"value": "Tag value 1"
},
{
"key": "Tag 2",
"value": "Tag value 2"
}
]
}
Limited liability partnerships
The following is an API request example call where businessType = LIMITED_LIABILITY_PARTNERSHIP.
{
"region": "EU",
"businessDetails": {
"businessName": "SHIBAKU ELECTRIC LLP",
"businessRegistrationNumber": "320000024285",
"businessType": "LIMITED_LIABILITY_PARTNERSHIP",
"tradeName": "Shibaku Electric",
"website": "www.shibaku.com",
"legalDetails": {
"registeredCountry": "DE",
"registeredDate": "2018-11-12"
},
"addresses": {
"registeredAddress": {
"addressLine1": "Güntzelstrasse 99",
"city": "Mehring",
"state": "Freistaat Bayern",
"country": "DE",
"postcode": "84561"
}
},
"taxDetails": [
{
"country": "DE",
"taxNumber": "12223423"
}
],
"documentDetails": [
{
"documentType": "PARTNERSHIP_DEED",
"document": [
{
"fileName": "PartnershipDeed",
"fileType": "application/pdf",
"document": "JVBERi0xLjcNCiW1tbW1DQoxIDAgb2JqDQo8PC9UeXBlL0/mx0B52ekL8a01ftDTZUi1XyWkN9PsDj"
}
]
}
],
"stakeholders": [
{
"referenceId": "29aeb27f-4168-4125-a3b0-fa786f425a7c",
"businessPartner": {
"businessName": "KOLMAN COPPER INC.",
"businessRegistrationNumber": "900843822",
"businessEntityType": "SHAREHOLDER",
"addresses": {
"registeredAddress": {
"addressLine1": "Güntzelstrasse 99",
"city": "Mehring",
"state": "Freistaat Bayern",
"country": "DE",
"postcode": "84561"
}
},
"legalDetails": {
"registeredCountry": "DE"
},
"sharePercentage": "05.00"
}
},
{
"stakeholderDetails": {
"firstName": "JOHAN",
"middleName": "ATIKINSON",
"lastName": "KOLMAN",
"nationality": "GB",
"dateOfBirth": "1981-06-15",
"address": {
"addressLine1": "13 Hursley Road Chandlers Ford",
"city": "Eastleigh",
"state": "London",
"country": "GB",
"postcode": "SO53 2FW"
},
"professionalDetails": [
{
"position": "DIRECTOR"
}
],
"taxDetails": [
{
"country": "DE",
"taxNumber": "12223423"
}
],
"additionalInfo": {
"isPep": "No"
},
"documentDetails": [
{
"documentType": "PASSPORT",
"documentNumber": "Z3367529",
"documentIssuanceCountry": "GB",
"documentExpiryDate": "2026-01-04"
}
]
}
}
],
"applicantDetails": {
"firstName": "KATIE",
"middleName": "PATTERSON",
"lastName": "HOFFSTATER",
"nationality": "DE",
"dateOfBirth": "1981-06-15",
"address": {
"addressLine1": "Güntzelstrasse 99",
"city": "Mehring",
"state": "Freistaat Bayern",
"country": "DE",
"postcode": "84561"
},
"contactDetails": {
"contactNo": "8897681220",
"email": "[email protected]",
"countryCode": "DE"
},
"professionalDetails": [
{
"position": "DIRECTOR"
}
],
"kycMode": "E_DOC_VERIFY",
"birthCountry": "DE",
"additionalInfo": {
"isPep": "No"
},
"documentDetails": [
{
"documentType": "PASSPORT",
"documentNumber": "Z3367659",
"documentIssuanceCountry": "SG",
"documentExpiryDate": "2026-01-04"
}
]
},
"additionalInfo": {
"searchId": "e23e8883-a58c-4003-adb3-41e31bc57282",
"isSameBusinessAddress": "Yes"
}
},
"riskAssessmentInfo": {
"totalEmployees": "EM005",
"annualTurnover": "EU001",
"industrySector": "IS053",
"intendedUseOfAccount": "IU004",
"countryOfOperation": [
"DE"
],
"transactionCountries": [
"US",
"AU",
"DE"
]
},
"tags": [
{
"key": "Tag 1",
"value": "Tag value 1"
},
{
"key": "Tag 2",
"value": "Tag value 2"
}
]
}
Updated about 6 hours ago