EU required fields

📘
NOTE
The API fields shown on this page are relevant to the European Union only.
To see the full payload, see API Reference.

📘
NOTE
Throughout this page, the Trust/SoleTr/Assn columns include:

Trust

Sole trader

Associations

Throughout this page, the Private/Public/Govt columns include:

Private companies

Public companies

Government bodies

Throughout this page, the LLP columns are Limited Liability Partnerships.

Request parameters

Property	Description	Type
`region`	The country or geographic region where the end-corporate customer is located and is onboarded. To onboard an EU-based customer, use the `EU` value.	Required
businessDetails	An object that accepts business details about the corporate customer.	Required
riskAssessmentInfo	An object for the risk assessment information.	Required
tags	An object for the tags.	Optional
`clientId`	This field accepts the Nium client Id of the customer. It is received in the response of the previously executed Onboard Corporate Customer API. It's required only to re-initiate the KYB process.	Optional
`customerHashId`	This field accepts the unique customer identifier generated at the time of customer creation. It is received in the response of the previously executed Onboard Corporate Customer API. It's required only to re-initiate the KYB process.	Optional

`businessDetails` object

An object that accepts business details about the corporate customer.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`referenceId`	The universally unique identifier (UUID) of the business entity that Nium uses to identify the `businessDetails` entity. If it's not provided, Nium generates one. The UUID is used to respond to a request for information (RFI) or to upload required documents for the business entity.	Optional	Optional	Optional
`businessName`	The name a corporate customer is registered under.	Required	Required	Required
`businessRegistrationNumber`	The business registration number.	Required	Required	Required
`tradeName`	In case the corporate customer is doing business under a different name than their licensed business name.	N/A	Required	Optional
`website`	A company's set of related web pages located under a single domain name.	Optional	Optional	Optional
`businessType`	The legal entity type of the business. See Enum values for a valid set of values.	Required	Required	Required
legalDetails	An object for the legal details.	Required	Required	Required
taxDetails	An object for the business taxation details.	Required	Required	Required
address	An object for the registered and business addresses of the corporate customer.	Required	Required	Required
documentDetails	An object for the business documents. This is required if `searchId` is not present.	Conditional	Conditional	Conditional
stakeholders	An object for the individual and corporate stakeholders of the corporate customer.	Required	Required	Required
applicantDetails	An object for the applicant details.	Required	Required	Required
additionalInfo	An object for additional information about the business.	Optional	Optional	Optional

`legalDetails` object

An object within the businessDetails object to accept legal details.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`registeredDate`	The date the business was registered entered in `yyyy-mm-dd` format.	Required	Required	Required
`registeredCountry`	The country where the business is registered, specified in ISO 3166 format.	Required	Required	Required

`taxDetails` object

An array of objects within the businessDetails object to accept multiple values of taxation details of the corporate customer.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`country`	The country of residence for tax purposes, specified in ISO 3166 format.	Required	Required	Required
`taxNumber`	The tax ID number for this country.	Required	Required	Required

`address` object

An object within the businessDetails object to accept registered and business addresses.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
registeredAddress	An object for the address where the business is registered.	Required	Required	Required
businessAddress	An object for the address where the business is mainly conducted, if different than the registered address.	Optional	Optional	Optional

`registeredAddress` object

An object within the businessDetails.address object to accept the address details where the corporate customer is registered.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`addressLine1`	The first address line of the registered business.	Required	Required	Required
`addressLine2`	The second address line of the registered business.	Optional	Optional	Optional
`city`	The city where the corporate customer is registered.	Required	Required	Required
`state`	The state where the corporate customer is registered.	Required	Required	Required
`country`	The country where the corporate customer is registered, specified in ISO 3166 format.	Required	Required	Required
`postcode`	The postal code where the corporate customer is registered.	Required	Required	Required

`businessAddress` object

An object within the businessDetails.address object to accept the address details of the principal place of business only when the registered address is different.

📘
NOTE
Use these fields only if the principal place of business is different than the registered address.
These fields are required only if isSameBusinessAddress = NO.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`addressLine1`	The first address line of the principal place of business if different than the registered business.	Conditional	Conditional	Conditional
`addressLine2`	The second address line of the principal place of business if different than the registered business.	Optional	Optional	Optional
`city`	The city of the principal place of business if different than the registered address.	Conditional	Conditional	Conditional
`state`	The state of the principal place of business if different than the registered address.	Conditional	Conditional	Conditional
`country`	The country where the principal place of business occurs if different than the registered country, specified in ISO 3166 format.	Conditional	Conditional	Conditional
`postcode`	The postal code where the principal place of business occurs if different than the registered address.	Conditional	Conditional	Conditional

`documentDetails` object

An object within the businessDetails object to accept one or more business documents.

📘
NOTE
These fields are required only if searchId is not present.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`documentType`	The type of business document. See Enum values for a valid set of values.	Conditional	Conditional	Conditional
document	An object for a copy of the document.	Conditional	Conditional	Conditional

`document` object

A required object within the businessDetails.documentDetails object.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`fileName`	The name of the file.	Conditional	Conditional	Conditional
`fileType`	The type of the file.	Conditional	Conditional	Conditional
`document`	The file as a base64 encoded string.	Conditional	Conditional	Conditional

`additionalInfo` object

An object within the businessDetails object for additional information about the business.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`isSameBusinessAddress`	This field accepts `Yes` or `No` to indicate if the principal place of business is the same or different from the registered business entity address. Required only if `Yes`; optional if `No`.	Optional	Optional	Optional
`searchId`	This field is required for eKYB and is returned in the response of the Exhaustive Corporate Details using Business ID API.	Optional	Optional	Optional
`businessExtractCoveredStakeholder`	This is required only for `PUBLIC_COMPANY` and `PRIVATE_COMPANY` entities. This field accepts `Yes` or `No` to indicate if the business extract document given covers the stakeholder details.	n/a	Optional	n/a

`stakeholders` object

An object within the businessDetails object to accept one or many stakeholders' information.

For every stakeholder object, send either the stakeholderDetails or the businessPartner parameters.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`referenceId`	The universal unique identifier (UUID) associated with the stakeholder and stakeholder object. If the UUID isn't provided, Nium generates one. The UUID can be used to respond to an RFI or to upload the required documents.	Optional	Optional	Optional
stakeholderDetails	An object for the details of the individual stakeholder.	Required	Required	Required
businessPartner	An object for the details of the corporate stakeholder, if available.	Required	Required	Required

`stakeholderDetails` object

A required object within the stakeholders object for the details of an individual stakeholder.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`kycMode`	The KYC mode for verifying the individual stakeholder. Applicable values are `E_KYC` and `MANUAL_KYC`.	Required	Required	Required
`firstName`	The first name of the individual stakeholder.	Required	Required	Required
`middleName`	The middle name of the individual stakeholder.	Optional	Optional	Optional
`lastName`	The surname of the individual stakeholder.	Required	Required	Required
`nationality`	The nationality of the individual stakeholder.	Required	Required	Required
`dateOfBirth`	The date the individual stakeholder was born in the `yyyy-mm-dd` format.	Required	Required	Required
`birthCountry`	The country of birth. Required only if the individual stakeholder's position is `ULTIMATE_BENEFICIAL_OWNER`, `TRUSTEE`, or `PARTNER`.	Conditional	Conditional	Conditional
taxDetails	The taxation details of the individual stakeholder. Required if position is `ULTIMATE_BENEFICIAL_OWNER`, `TRUSTEE`, or `PARTNER`.	Conditional	Conditional	Conditional
professionalDetails	The professional details of the individual stakeholder.	Required	Required	Required
address	An object for the residential address of the individual stakeholder.	Required	Required	Required
contactDetails	An object for the contact details of the individual stakeholder.	Optional	Optional	Optional
documentDetails	An object for the document details of the individual stakeholder.	Required	Required	Required
additionalInfo	An object for additional information about the individual stakeholder.	Required	Required	Required

`taxDetails` object

An array of objects within the businessDetails.stakeholders.stakeholderDetails object for the individual stakeholder's tax details of one or more countries.

📘
NOTE
This is required only if position is ULTIMATE_BENEFICIAL_OWNER, TRUSTEE, or PARTNER.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`country`	The country of the stakeholder's residence. of the individual stakeholder, specified in ISO 3166 format.	Conditional	Conditional	Conditional
`taxNumber`	The Tax ID number for the corresponding country.	Conditional	Conditional	Conditional

`professionalDetails` object

A required object within the businessDetails.stakeholders.stakeholderDetails object for the individual stakeholder's professional details.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`position`	The position of the individual stakeholder. See Enum values for the valid set of values.	Required	Required	Required
`sharePercentage`	The share percentage of the individual stakeholder in the company. If the stakeholder’s position is `ULTIMATE_BENEFICIAL_OWNER`, then the share percentage is a required input parameter.	Conditional	Conditional	Conditional
`positionStartDate`	The date the individual stakeholder started the position of `ULTIMATE_BENEFICIAL_OWNER`. This is required only if the individual stakeholder is currently an `ULTIMATE_BENEFICIAL_OWNER`.	Conditional	Conditional	Conditional

`address` object

A required object within the businessDetails.stakeholders.stakeholderDetails object for the individual stakeholder's residential address.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`addressLine1`	The first address line of the individual stakeholder.	Required	Required	Required
`addressLine2`	The second address line of the individual stakeholder.	Optional	Optional	Optional
`city`	The city or suburb of the individual stakeholder.	Required	Required	Required
`state`	The state of the individual stakeholder.	Required	Required	Required
`country`	The country where the individual stakeholder resides, specified in ISO 3166 format.	Required	Required	Required
`postcode`	The postal code of the individual stakeholder.	Required	Required	Required

`contactDetails` object

An optional object within the businessDetails.stakeholders.stakeholderDetails object for the stakeholder's contact information.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`email`	The individual stakeholder's email address.	Optional	Optional	Optional
`contactNo`	The contact phone number of the individual stakeholder.	Optional	Optional	Optional

`documentDetails` object

A required object within the businessDetails.stakeholders.stakeholderDetails object for the individual stakeholder's document details.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`documentType`	The type of document. See enum Values for a valid set of values.	Required	Required	Required
`documentNumber`	The ID number for the given document type.	Required	Required	Required
`documentIssuanceCountry`	The country that issued the business document, specified in ISO 3166 format. This is required only if `documentType = PASSPORT`.	Conditional	Conditional	Conditional
`documentExpiryDate`	The date the document will expire in `yyyy-mm-dd` format. This is required only if `documentType = PASSPORT`.	Conditional	Conditional	Conditional

`additionalInfo` object

An object within the businessDetails.stakeholders.stakeholderDetails object for additional information about the individual stakeholder.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`isPep`	This field accepts `Yes` or `No` to indicate if the individual stakeholder is a politically exposed person.	Required	Required	Required

`businessPartner`

If there is a corporate stakeholder, this is a required object within the businessDetails.stakeholders object with the business details of the corporate stakeholder.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`businessName`	The registered business name of the corporate stakeholder.	Required	Required	Required
`businessRegistrationNumber`	The business registration number.	Required	Required	Required
`businessEntityType`	The position of the corporate stakeholder in the company. See Enum values for a valid set of values.	Required	Required	Required
`sharePercentage`	The share percentage of the corporate stakeholder in the company. If the stakeholder’s position is `ULTIMATE_BENEFICIAL_OWNER`, then the share percentage is a required input parameter.	Conditional	Conditional	Conditional
legalDetails	An object for the legal details of the corporate stakeholder.	Required	Required	Required

`legalDetails` object

A required object within the businessDetails.stakeholders.businessPartner object for the corporate stakeholder's legal details.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`registeredCountry`	The country where the corporate stakeholder is registered, specified in ISO 3166 format.	Required	Required	Required

`applicantDetails` object

A required object within the businessDetails object that contains details about the applicant.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`referenceId`	The universally unique identifier (UUID) associated with the applicant and applicant object. If the UUID isn't provided, Nium generates one. The UUID can be used to respond to an RFI or to upload required documents.	Optional	Optional	Optional
`kycMode`	The KYC mode for verifying the identity of the applicant. Applicable values are `E_KYC` and `MANUAL_KYC`.	Required	Required	Required
`firstName`	The first name of the applicant. Maximum character length is 40.	Required	Required	Required
`middleName`	The middle name of the applicant. Maximum character length is 40.	Optional	Optional	Optional
`lastName`	The surname or the applicant. Maximum character length is 40.	Required	Required	Required
`nationality`	Nationality of the applicant.	Required	Required	Required
`dateOfBirth`	The date on which the applicant was born in `yyyy-mm-dd` format.	Required	Required	Required
`birthCountry`	The country of birth. Required only if the applicant's position is `ULTIMATE_BENEFICIAL_OWNER`, `TRUSTEE`, or `PARTNER`.	Conditional	Conditional	Conditional
professionalDetails	An object for the professional details of the applicant.	Required	Required	Required
address	An object for the address of the applicant.	Required	Required	Required
contactDetails	An object for the contact details of the applicant.	Required	Required	Required
documentDetails	An object for the document details of the applicant.	Required	Required	Required
additionalInfo	An object for additional information about the applicant.	Required	Required	Required

`professionalDetails` object

A required object within the businessDetails.applicantDetails object for the professional details of the applicant.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`position`	The position of the applicant. See Enum values for a valid set of values.	Required	Required	Required
`sharePercentage`	The share percentage of the applicant in the company. If the applicant's position is `ULTIMATE_BENEFICIAL_OWNER`, then the share percentage is a required input parameter.	Conditional	Conditional	Conditional

`address` object

A required object within the businessDetails.applicantDetails object for the applicant's residential address.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`addressLine1`	The first address line of the applicant. Maximum character length is 40.	Required	Required	Required
`addressLine2`	The second address line of the applicant. Maximum character length is 40.	Optional	Optional	Optional
`city`	The city of the applicant. Maximum character length is 50.	Required	Required	Required
`state`	The state of the applicant. Maximum character length is 50.	Required	Required	Required
`country`	The country where the applicant resides, specified in ISO 3166 format.	Required	Required	Required
`postcode`	The postal code of the applicant. The character length minimum is 3 and maximum is 10.	Required	Required	Required

`contactDetails` object

A required object within the businessDetails.applicantDetails object for the applicant's contact information.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`email`	The applicant's email address. Maximum character length is 40.	Required	Required	Required
`countryCode`.	The country code of the applicant's phone number.	Required	Required	Required
`contactNo`	The applicant's phone number. Maximum character length is 20.	Required	Required	Required

`documentDetails` object

A required object within the businessDetails.applicantDetails object for the applicant's document information.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`documentType`	The type of document. See Enum values for a valid set of values.	Required	Required	Required
`documentNumber`	The ID number for the given document type.	Required	Required	Required
`documentIssuanceCountry`	The country that issued the business document, specified in ISO 3166 format. This is required only if `documentType = PASSPORT`.	Conditional	Conditional	Conditional
`documentExpiryDate`	The date the document will expire in `yyyy-mm-dd` format. This is required only if `documentType = PASSPORT`.	Conditional	Conditional	Conditional
document	An object for the copy of the document.	Conditional	Conditional	Conditional

`document` object

An object within the businessDetails.applicantDetails.documentDetails object for the document copy.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`fileName`	The name of the file.	Conditional	Conditional	Conditional
`fileType`	The file type. Required only for trusts.	Conditional	Conditional	Conditional
`document`	The document saved as a base64 encoded string. Required only for trusts.	Conditional	Conditional	Conditional

`additionalInfo` object

An object within the businessDetails.applicantDetails object that contains additional information about the applicant.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`isPep`	This field accepts `Yes` or `No` to indicate if the applicant is a politically exposed person.	Required	Required	Required

`riskAssessmentInfo` object

The following are the details required to determine a Risk profile.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`totalEmployees`	The corporate customer's total number of employees. See Enum values for valid values.	Required	Required	Required
`annualTurnover`	The corporate customer's amount of annual employee turnover. See Enum values for valid values.	Required	Required	Required
`industrySector`	The corporate customer's industry sector. See Enum values for valid values.	Required	Required	Required
`countryOfOperation`	The country the corporate customer operates in, specified in ISO 3166 format.	Required	Required	Required
`transactionCountries`	The array of countries where the transactions occur, specified in ISO 3166 format.	Required	Required	Required
`intendedUseOfAccount`	The customer's intended use of the account. See Enum values for valid values.	Required	Required	Required

`tags` object

This object contains the user-defined key-value pairs that the client provides. The maximum number of tags is 15.

Property	Description	Trust/SoleTr/Assn	Private/Public/Govt	LLP
`key`	The name of the tag. The maximum character length is 128.	Optional	Optional	Optional
`value`	The value of the tag. The maximum character length is 256.	Optional	Optional	Optional

EU required fields

📘
NOTE

📘
NOTE

Request parameters

`businessDetails` object

`legalDetails` object

`taxDetails` object

`address` object

`registeredAddress` object

`businessAddress` object

📘
NOTE

`documentDetails` object

📘
NOTE

`document` object

`additionalInfo` object

`stakeholders` object

`stakeholderDetails` object

`taxDetails` object

📘
NOTE

`professionalDetails` object

`address` object

`contactDetails` object

`documentDetails` object

`additionalInfo` object

`businessPartner`

`legalDetails` object

`applicantDetails` object

`professionalDetails` object

`address` object

`contactDetails` object

`documentDetails` object

`document` object

`additionalInfo` object

`riskAssessmentInfo` object

`tags` object

📘NOTE

📘NOTE

Request parameters

businessDetails object

legalDetails object

taxDetails object

address object

registeredAddress object

businessAddress object

📘NOTE

documentDetails object

📘NOTE

document object

additionalInfo object

stakeholders object

stakeholderDetails object

taxDetails object

📘NOTE

professionalDetails object

address object

contactDetails object

documentDetails object

additionalInfo object

businessPartner

legalDetails object

applicantDetails object

professionalDetails object

address object

contactDetails object

documentDetails object

document object

additionalInfo object

riskAssessmentInfo object

tags object

📘
NOTE

📘
NOTE

`businessDetails` object

`legalDetails` object

`taxDetails` object

`address` object

`registeredAddress` object

`businessAddress` object

📘
NOTE

`documentDetails` object

📘
NOTE

`document` object

`additionalInfo` object

`stakeholders` object

`stakeholderDetails` object

`taxDetails` object

📘
NOTE

`professionalDetails` object

`address` object

`contactDetails` object

`documentDetails` object

`additionalInfo` object

`businessPartner`

`legalDetails` object

`applicantDetails` object

`professionalDetails` object

`address` object

`contactDetails` object

`documentDetails` object

`document` object

`additionalInfo` object

`riskAssessmentInfo` object

`tags` object