US 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:
Public companies
The following is an API request example call where businessType = PUBLIC_COMPANY
.
{
"region": "US",
"businessDetails": {
"businessName": "Jubliant Public Corporations10",
"businessRegistrationNumber": "52940398934",
"businessType": "PUBLIC_COMPANY",
"description": "Public company in US to facilitate agro payments",
"legalDetails": {
"registeredCountry": "US",
"registeredDate": "2021-08-10",
"listedExchange": "EX103"
},
"stockSymbol": "MLFP",
"addresses": {
"registeredAddress": {
"addressLine1": "999 Park Street",
"addressLine2": "Near Airport",
"city": "Newark",
"state": "New Jersey",
"country": "US",
"postcode": "07071"
}
},
"documentDetails": [
{
"documentType": "PROOF_OF_EXISTENCE",
"document": [
{
"fileName": "POE",
"fileType": "application/pdf",
"document": "iVBORw0KGgoAAAANSUhEUgAAAOEAAADhCAMAAAAJbSJIAAAAJFBMVEX/////QAAAAADnOQCnIAD19vZSXV7dNgCkpqf1PQDNzs7P0NCe8r63AAAAoUlEQVR4nO3Wiw3DIAwFQGI+Ccn++1ZNM0IpEr2b4D1ZGKcEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMC31FpnRxjqbBHRztkxxjmi5J5LHLODjHLGvr3tcc2OMkgr20dps6OMUSM/DXOsuW5q9KdhX7bh6jNc/x3+wS5d/z9M6bpvmmUneFv9LgUAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+K0XNkoBrhhCyKYAAAAASUVORK5CYII="
}
]
}
],
"stakeholders": [
{
"stakeholderDetails": {
"kycMode": "MANUAL_KYC",
"firstName": "MARTHA",
"lastName": "JONES",
"nationality": "US",
"dateOfBirth": "1961-08-11",
"professionalDetails": [
{
"position": "CONTROL_PRONG"
}
],
"address": {
"addressLine1": "Park Street",
"city": "Newark",
"state": "New Jersey",
"country": "US",
"postcode": "07071"
},
"documentDetails": [
{
"documentType": "NATIONAL_ID",
"documentNumber": "555456789",
"documentIssuanceCountry": "US",
"document": [
{
"fileName": "POI.png",
"fileType": "images/png",
"document": "gtudfsdfgegetg"
}
]
}
]
}
},
{
"businessPartner": {
"businessName": "Lightsaber Fintech Venture",
"businessRegistrationNumber": "987609384",
"businessEntityType": "UBO",
"sharePercentage": "15",
"legalDetails": {
"registeredCountry": "US"
}
}
}
],
"applicantDetails": {
"kycMode": "E_KYC",
"firstName": "John",
"lastName": "Arch",
"nationality": "US",
"dateOfBirth": "1982-07-10",
"professionalDetails": [
{
"position": "SIGNATORY"
}
],
"contactDetails": {
"countryCode": "US",
"contactNo": "9974922222",
"email": "[email protected]"
},
"address": {
"addressLine1": "Apt X 99, Green Avenue",
"city": "West Hartford",
"state": "Connecticut",
"postcode": "06110",
"country": "US"
},
"documentDetails": [
{
"documentType": "NATIONAL_ID",
"documentNumber": "123456789",
"documentIssuanceCountry": "US"
}
],
"additionalInfo": {
"applicantDeclaration": "Yes"
}
},
"additionalInfo": {
"isSameBusinessAddress": "Yes"
}
},
"riskAssessmentInfo": {
"totalEmployees": "EM005",
"annualTurnover": "US007",
"industrySector": "IS033",
"intendedUseOfAccount": "IU009",
"countryOfOperation": [
"US",
"SG",
"HK",
"AU"
],
"transactionCountries": [
"SG",
"AU",
"EU"
]
},
"tags": [
{
"key": "tag1",
"value": "tag1value"
},
{
"key": "tag2",
"value": "tag2value"
}
]
}
Trusts
The following is an API request example call where businessType = TRUST
.
{
"region": "US",
"businessDetails": {
"businessName": "Farhampton Children Trust25",
"businessRegistrationNumber": "52940397834",
"businessType": "TRUST",
"description": "Trust in US to support specially abled children",
"legalDetails": {
"registeredCountry": "US",
"registeredDate": "2021-08-10"
},
"addresses": {
"registeredAddress": {
"addressLine1": "999 Park Street",
"addressLine2": "Near Airport",
"city": "Newark",
"state": "New Jersey",
"country": "US",
"postcode": "07071"
}
},
"regulatoryDetails": {
"unregulatedTrustType": [
"TT002"
]
},
"documentDetails": [
{
"documentType": "TRUST_DEED",
"document": [
{
"fileName": "TRUSTDEED",
"fileType": "application/pdf",
"document": "iVBORw0KGgoAAAANSUhEUgAAAOEAAADhCAMAAAAJbSJIAAAAJFBMVEX/////QAAAAADnOQCnIAD19vZSXV7dNgCkpqf1PQDNzs7P0NCe8r63AAAAoUlEQVR4nO3Wiw3DIAwFQGI+Ccn++1ZNM0IpEr2b4D1ZGKcEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMC31FpnRxjqbBHRztkxxjmi5J5LHLODjHLGvr3tcc2OMkgr20dps6OMUSM/DXOsuW5q9KdhX7bh6jNc/x3+wS5d/z9M6bpvmmUneFv9LgUAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+K0XNkoBrhhCyKYAAAAASUVORK5CYII="
}
]
}
],
"stakeholders": [
{
"stakeholderDetails": {
"kycMode": "MANUAL_KYC",
"firstName": "KATIE",
"lastName": "WINCELET",
"nationality": "US",
"dateOfBirth": "1961-08-11",
"professionalDetails": [
{
"position": "CONTROL_PRONG"
}
],
"address": {
"addressLine1": "Park Street",
"city": "Newark",
"state": "New Jersey",
"country": "US",
"postcode": "07071"
},
"documentDetails": [
{
"documentType": "NATIONAL_ID",
"documentNumber": "555456789",
"documentIssuanceCountry": "US",
"document": [
{
"fileName": "POI.png",
"fileType": "images/png",
"document": "gtudfsdfgegetg"
}
]
}
]
}
},
{
"businessPartner": {
"businessName": "Amanda Corp",
"businessRegistrationNumber": "987609384",
"businessEntityType": "UBO",
"sharePercentage": "15",
"legalDetails": {
"registeredCountry": "US"
}
}
}
],
"applicantDetails": {
"kycMode": "E_KYC",
"firstName": "Tom",
"lastName": "Cruise",
"nationality": "US",
"dateOfBirth": "1982-07-10",
"professionalDetails": [
{
"position": "SIGNATORY"
}
],
"contactDetails": {
"countryCode": "US",
"contactNo": "9974922222",
"email": "[email protected]"
},
"address": {
"addressLine1": "Apt X 99, Green Avenue",
"city": "West Hartford",
"state": "Connecticut",
"postcode": "06110",
"country": "US"
},
"documentDetails": [
{
"documentType": "NATIONAL_ID",
"documentNumber": "123456789",
"documentIssuanceCountry": "US"
}
],
"additionalInfo": {
"applicantDeclaration": "Yes"
}
},
"additionalInfo": {
"isSameBusinessAddress": "Yes"
}
},
"riskAssessmentInfo": {
"totalEmployees": "EM005",
"annualTurnover": "US007",
"industrySector": "IS033",
"intendedUseOfAccount": "IU009",
"countryOfOperation": [
"US",
"SG",
"HK",
"AU"
],
"transactionCountries": [
"SG",
"AU",
"EU"
]
},
"tags": [
{
"key": "tag1",
"value": "tag1value"
},
{
"key": "tag2",
"value": "tag2value"
}
]
}
Other entities
The following is an API request example call where businessType = CORPORATION
. Examples for other entity types listed below are similar.
- Corporations
- Estates
- General partnerships
- Limited liability company
- Limited liability partnership firms
- Limited partnerships
- Sole traders
- Unincorporated associations
{
"region": "US",
"businessDetails": {
"businessName": "Soylent Corporation68s",
"businessRegistrationNumber": "529403988",
"businessType": "CORPORATION",
"description": "Corporation in US to facilitate payments to business",
"tradeName": "Soylent Corp",
"legalDetails": {
"registeredCountry": "US",
"registeredDate": "2021-08-10"
},
"addresses": {
"registeredAddress": {
"addressLine1": "999 Park Street",
"addressLine2": "Near Airport",
"city": "Newark",
"state": "New Jersey",
"country": "US",
"postcode": "07071"
}
},
"documentDetails": [
{
"documentType": "BUSINESS_REGISTRATION_DOC",
"document": [
{
"fileName": "BRD",
"fileType": "application/pdf",
"document": "iVBORw0KGgoAAAANSUhEUgAAAOEAAADhCAMAAAAJbSJIAAAAJFBMVEX/////QAAAAADnOQCnIAD19vZSXV7dNgCkpqf1PQDNzs7P0NCe8r63AAAAoUlEQVR4nO3Wiw3DIAwFQGI+Ccn++1ZNM0IpEr2b4D1ZGKcEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMC31FpnRxjqbBHRztkxxjmi5J5LHLODjHLGvr3tcc2OMkgr20dps6OMUSM/DXOsuW5q9KdhX7bh6jNc/x3+wS5d/z9M6bpvmmUneFv9LgUAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+K0XNkoBrhhCyKYAAAAASUVORK5CYII="
}
]
}
],
"stakeholders": [
{
"stakeholderDetails": {
"kycMode": "MANUAL_KYC",
"firstName": "MICHAEL",
"lastName": "JONES",
"nationality": "US",
"dateOfBirth": "1961-08-11",
"professionalDetails": [
{
"position": "CONTROL_PRONG"
}
],
"address": {
"addressLine1": "Park Street",
"city": "Newark",
"state": "New Jersey",
"country": "US",
"postcode": "07071"
},
"documentDetails": [
{
"documentType": "NATIONAL_ID",
"documentNumber": "555456789",
"documentIssuanceCountry": "US",
"document": [
{
"fileName": "POI.png",
"fileType": "images/png",
"document": "gtudfsdfgegetg"
}
]
}
]
}
},
{
"businessPartner": {
"businessName": "Vehement Capital Partners",
"businessRegistrationNumber": "987609384",
"businessEntityType": "UBO",
"sharePercentage": "15",
"legalDetails": {
"registeredCountry": "US"
}
}
}
],
"applicantDetails": {
"kycMode": "E_KYC",
"firstName": "Tom",
"lastName": "Arch",
"nationality": "US",
"dateOfBirth": "1982-07-10",
"professionalDetails": [
{
"position": "SIGNATORY"
}
],
"contactDetails": {
"countryCode": "US",
"contactNo": "9974922222",
"email": "[email protected]"
},
"address": {
"addressLine1": "Apt X 99, Green Avenue",
"city": "West Hartford",
"state": "Connecticut",
"postcode": "06110",
"country": "US"
},
"documentDetails": [
{
"documentType": "NATIONAL_ID",
"documentNumber": "123456789",
"documentIssuanceCountry": "US"
}
],
"additionalInfo": {
"applicantDeclaration": "Yes"
}
},
"additionalInfo": {
"isSameBusinessAddress": "Yes"
}
},
"riskAssessmentInfo": {
"totalEmployees": "EM005",
"annualTurnover": "US007",
"industrySector": "IS033",
"intendedUseOfAccount": "IU009",
"countryOfOperation": [
"US",
"SG",
"HK",
"AU"
],
"transactionCountries": [
"SG",
"AU",
"EU"
]
},
"tags": [
{
"key": "tag1",
"value": "tag1value"
},
{
"key": "tag2",
"value": "tag2value"
}
]
}
Simulate various scenarios
You can generate the following scenarios by following the steps below the table.
Request scenario |
---|
Auto-approval |
Action required |
In progress with documents required |
Prerequisites
Before calling the Onboard Corporate Customer API, you need to do the following:
- Change the
businessDetails.businessRegistrationNumber
from its default value of111111111
to a unique number and changebusinessDetails.businessName
to a unique name. A customer doesn't need to be re-onboarded from the Nium One platform if they already have an account with Nium. - Change
stakeholderDetails.lastname
andbusinessPartner.businessName
to make them unique. - Ensure that the applicant’s details match with one of the individual stakeholders in the
businessDetails.stakeholders.stakeholderDetails
object. This is required only for testing the scenarios and is not required in the production environment. - Don't change the address in the example request.
Calling the API
After following the prerequisites, use the below example requests to call the Onboard Corporate Customer API.
Request example: auto-approval
{
"region": "US",
"businessDetails": {
"businessName": "TESSERACT LLC WFWEF",
"businessRegistrationNumber": "529402356",
"businessType": "LIMITED_LIABILITY_COMPANY",
"description": "Limited liability company in US for IT services",
"legalDetails": {
"registeredCountry": "US",
"registeredDate": "2021-08-10"
},
"addresses": {
"registeredAddress": {
"addressLine1": "223, Grand St.",
"addressLine2": "",
"city": "New York",
"state": "NY",
"country": "US",
"postcode": "10013"
}
},
"stakeholders": [
{
"stakeholderDetails": {
"kycMode": "E_KYC",
"firstName": "MARTHA",
"lastName": "ENGLISH REBORN",
"nationality": "US",
"dateOfBirth": "1961-08-11",
"professionalDetails": [
{
"position": "CONTROL_PRONG"
}
],
"address": {
"addressLine1": "Park Street",
"city": "Newark",
"state": "New Jersey",
"country": "US",
"postcode": "07071"
},
"documentDetails": [
{
"documentType": "NATIONAL_ID",
"documentNumber": "555456789",
"documentIssuanceCountry": "US"
}
]
}
},
{
"businessPartner": {
"businessName": "CUZEK PRIVATE VENTURES",
"businessRegistrationNumber": "987609384",
"businessEntityType": "UBO",
"sharePercentage": "15",
"legalDetails": {
"registeredCountry": "US"
}
}
}
],
"applicantDetails": {
"kycMode": "E_KYC",
"firstName": "MARTHA",
"lastName": "ENGLISH REBORN",
"nationality": "US",
"dateOfBirth": "1961-08-11",
"professionalDetails": [
{
"position": "SIGNATORY"
}
],
"contactDetails": {
"countryCode": "US",
"contactNo": "9974922222",
"email": "[email protected]"
},
"address": {
"addressLine1": "Apt X 99, Green Avenue",
"city": "West Hartford",
"state": "Connecticut",
"postcode": "06110",
"country": "US"
},
"documentDetails": [
{
"documentType": "NATIONAL_ID",
"documentNumber": "555456789",
"documentIssuanceCountry": "US"
}
],
"additionalInfo": {
"applicantDeclaration": "Yes"
}
},
"additionalInfo": {
"isSameBusinessAddress": "Yes"
}
},
"riskAssessmentInfo": {
"totalEmployees": "EM009",
"annualTurnover": "US011",
"industrySector": "IS141",
"intendedUseOfAccount": "IU003",
"countryOfOperation": [
"US",
"SG",
"HK",
"AU"
],
"transactionCountries": [
"SG",
"AU",
"EU"
]
},
"tags": [
{
"key": "tag1",
"value": "tag1value"
},
{
"key": "tag2",
"value": "tag2value"
}
]
}
Request example: action required
{
"region": "US",
"businessDetails": {
"businessName": "TESSERACT LLC WFRRF",
"businessRegistrationNumber": "529404336",
"businessType": "LIMITED_LIABILITY_COMPANY",
"description": "Limited liability company in US for IT services",
"legalDetails": {
"registeredCountry": "US",
"registeredDate": "2021-08-10"
},
"addresses": {
"registeredAddress": {
"addressLine1": "Random Address",
"addressLine2": "",
"city": "Gotham City",
"state": "NY",
"country": "US",
"postcode": "10013"
}
},
"stakeholders": [
{
"stakeholderDetails": {
"kycMode": "E_KYC",
"firstName": "MARTHA WAS",
"lastName": "ENGLISH IS",
"nationality": "US",
"dateOfBirth": "1961-08-11",
"professionalDetails": [
{
"position": "CONTROL_PRONG"
}
],
"address": {
"addressLine1": "Park Street",
"city": "Newark",
"state": "New Jersey",
"country": "US",
"postcode": "07071"
},
"documentDetails": [
{
"documentType": "NATIONAL_ID",
"documentNumber": "555456789",
"documentIssuanceCountry": "US"
}
]
}
},
{
"businessPartner": {
"businessName": "CUZEK PRIVATE VENTURES",
"businessRegistrationNumber": "987609384",
"businessEntityType": "UBO",
"sharePercentage": "15",
"legalDetails": {
"registeredCountry": "US"
}
}
}
],
"applicantDetails": {
"kycMode": "E_KYC",
"firstName": "MARTHA IS",
"lastName": "ENGLISH WAS",
"nationality": "US",
"dateOfBirth": "1961-08-11",
"professionalDetails": [
{
"position": "SIGNATORY"
}
],
"contactDetails": {
"countryCode": "US",
"contactNo": "9974922222",
"email": "[email protected]"
},
"address": {
"addressLine1": "Apt X 99, Green Avenue",
"city": "West Hartford",
"state": "Connecticut",
"postcode": "06110",
"country": "US"
},
"documentDetails": [
{
"documentType": "NATIONAL_ID",
"documentNumber": "555456789",
"documentIssuanceCountry": "US"
}
],
"additionalInfo": {
"applicantDeclaration": "Yes"
}
},
"additionalInfo": {
"isSameBusinessAddress": "Yes"
}
},
"riskAssessmentInfo": {
"totalEmployees": "EM005",
"annualTurnover": "US007",
"industrySector": "IS033",
"intendedUseOfAccount": "IU009",
"countryOfOperation": [
"US",
"SG",
"HK",
"AU"
],
"transactionCountries": [
"SG",
"AU",
"EU"
]
},
"tags": [
{
"key": "tag1",
"value": "tag1value"
},
{
"key": "tag2",
"value": "tag2value"
}
]
}
Request example: in progress with documents required
{
"region": "US",
"businessDetails": {
"businessName": "TESSERACT LLC WFWEF",
"businessRegistrationNumber": "529402356",
"businessType": "LIMITED_LIABILITY_COMPANY",
"description": "Limited liability company in US for IT services",
"legalDetails": {
"registeredCountry": "US",
"registeredDate": "2021-08-10"
},
"addresses": {
"registeredAddress": {
"addressLine1": "223, Grand St.",
"addressLine2": "",
"city": "New York",
"state": "NY",
"country": "US",
"postcode": "10013"
}
},
"stakeholders": [
{
"stakeholderDetails": {
"kycMode": "E_KYC",
"firstName": "MARTHA",
"lastName": "ENGLISH REBORN",
"nationality": "US",
"dateOfBirth": "1961-08-11",
"professionalDetails": [
{
"position": "CONTROL_PRONG"
}
],
"address": {
"addressLine1": "Park Street",
"city": "Newark",
"state": "New Jersey",
"country": "US",
"postcode": "07071"
},
"documentDetails": [
{
"documentType": "NATIONAL_ID",
"documentNumber": "555456789",
"documentIssuanceCountry": "US"
}
]
}
},
{
"businessPartner": {
"businessName": "CUZEK PRIVATE VENTURES",
"businessRegistrationNumber": "987609384",
"businessEntityType": "UBO",
"sharePercentage": "15",
"legalDetails": {
"registeredCountry": "US"
}
}
}
],
"applicantDetails": {
"kycMode": "MANUAL_KYC",
"firstName": "MARTHA",
"lastName": "ENGLISH REBORN",
"nationality": "US",
"dateOfBirth": "1961-08-11",
"professionalDetails": [
{
"position": "SIGNATORY"
}
],
"contactDetails": {
"countryCode": "US",
"contactNo": "9974922222",
"email": "[email protected]"
},
"address": {
"addressLine1": "Apt X 99, Green Avenue",
"city": "West Hartford",
"state": "Connecticut",
"postcode": "06110",
"country": "US"
},
"additionalInfo": {
"applicantDeclaration": "Yes"
}
},
"additionalInfo": {
"isSameBusinessAddress": "Yes"
}
},
"riskAssessmentInfo": {
"totalEmployees": "EM005",
"annualTurnover": "US007",
"industrySector": "IS033",
"intendedUseOfAccount": "IU009",
"countryOfOperation": [
"US",
"SG",
"HK",
"AU"
],
"transactionCountries": [
"SG",
"AU",
"EU"
]
},
"tags": [
{
"key": "tag1",
"value": "tag1value"
},
{
"key": "tag2",
"value": "tag2value"
}
]
}
Updated 2 days ago