Skip to main content

Required Parameters

The page list the fields that apply to customers onboarded under the EU region. To view the complete request payload, see the Onboard Corporate Customer request.

note

All fields have a maximum length of 255 characters unless stated otherwise.

Request parameters

PropertyDescriptionRequired
regionThe regulatory region under which the corporate customer is being onboarded. To onboard under the EU region, use the EU value.Yes
businessDetailsContains information about the business, including the applicant and stakeholders.Yes
riskAssessmentInfoProvides additional business profile information, such as total number of employees and annual turnover.Yes
deviceDetailsIncludes the device and IP address from which the onboarding request originated.Yes
expectedAccountUsageDescribes how the customer expects to use the account.Yes
natureOfBusinessContains information about the nature of the business, such as the industrySector.Yes
tagsContains user-defined key-value pairs submitted by the client.No
customerHashIdA unique identifier returned in the response to the Onboard Corporate Customer request.

Note:* Required only when reinitiating KYB after a rejection.
Yes *

Note

All the fields listed below are applicable for all entity types:

  • Associations
  • Government Body
  • Limited Liability Partnership
  • Public Company
  • Private Limited Company
  • Sole Trader
  • Trust

businessDetails object

Contains information about the corporate customer, including the applicant and stakeholders.

PropertyDescriptionRequired
referenceIdA unique identifier for the business entity. If not provided, Nium generates one. Used to respond to RFIs or upload documents.No
businessNameThe registered name of the business.Yes
businessRegistrationNumberThe official registration number of the business.Yes
tradeNameThe name the business operates under. If the business doesn't use a trade name, set tradeName : businessName.Yes
websiteThe business’s website. If not available, submit a social media profile (such as Instagram or Facebook). If neither is available, upload a document with documentType : PROOF_OF_BUSINESS.No
businessTypeThe legal entity type, such as a private or public company. Use the Fetch Corporate Constants requests with category : businessType.Yes
legalDetailsRegistration and legal information for the business.Yes
taxDetailsTax identification details.Yes
addressesRegistered and operating addresses.Yes
documentDetailsBusiness documents.
For details, see EU Required Documents.
Yes *
stakeholdersInformation about the business’s stakeholders, such as directors or UBOs.Yes
applicantDetailsInformation about the individual submitting the application.Yes
additionalInfoOptional details related to the application.No

legalDetails object

Contains registration and legal information for the business.

PropertyDescriptionRequired
registeredDateThe date the business was registered entered in the YYYY-MM-DD format. Registered date cannot be a past date.Yes
registeredCountryThe country where the business is registered. Use Fetch corporate constants API for a valid set of values.Yes

Contains information about the corporate customer, including the applicant and stakeholders.

PropertyDescriptionRequired
referenceIdA unique identifier for the business entity. If not provided, Nium generates one. Used to respond to RFIs or upload documents.No
businessNameThe registered name of the business.Yes
businessRegistrationNumberThe official registration number of the business.Yes
tradeNameThe name the business operates under. If the business doesn't use a trade name, set tradeName : businessName.Yes
websiteThe business’s website. If not available, submit a social media profile (such as Instagram or Facebook). If neither is available, upload a document with documentType : PROOF_OF_BUSINESS.No
businessTypeThe legal entity type, such as a private or public company. Use the Fetch Corporate Constants requests with category : businessType.Yes
legalDetails#businessDetails-legalDetails)Registration and legal information for the business.Yes
taxDetails#businessDetails-taxDetails)Tax identification details.Yes
addresses#businessdetails-address)Registered and operating addresses.Yes
documentDetails#businessdetails-documentdetails)Business documents.
For details, see EU Required Documents.
Yes *
stakeholders#businessdetails-stakeholders)Information about the business’s stakeholders, such as directors or UBOs.Yes
applicantDetailsInformation about the individual submitting the application.Yes
additionalInfoOptional details related to the application.No

legalDetails object

Contains registration and legal information for the business.

PropertyDescriptionRequired
registeredDateThe date the business was registered entered in the YYYY-MM-DD format. Registered date cannot be a past date.Yes
registeredCountryThe country where the business is registered. Use Fetch corporate constants API for a valid set of values.Yes

taxDetails array

An array of objects within the businessDetails object that contains multiple values of taxation details of the corporate customer.

PropertyDescriptionRequired
countryThe country in which the corporate customer is paying taxes. This will be the same as the registered country, unless the customer is paying taxes in other countries as well. Note: If the customer is a subsidiary or a part of a group of companies, the customer needs to provide countries where taxes are paid for its own legal entity and not for the entire group of companies. Use Fetch Corporate Constants for a valid set of values with category=countryName.Yes
taxNumberThe tax ID number for this country. Max character length is 64 charactersYes

addresses object

An object within the businessDetails object that contain registered and business addresses.

PropertyDescriptionRequired
registeredAddressAn object that contains the address where the business is registered.Yes
businessAddressAn object that contains the address where the business is mainly conducted, if different than the registered address. Note: This is not required if isSameBusinessAddress= Yes is passed under businessDetails.additionalInfo.Yes *

registeredAddress object

An object within the businessDetails.address object that contains the address details where the corporate customer is registered.

PropertyDescriptionRequired
addressLine1The first address line of the registered address.Yes
addressLine2The second address line of the registered address.No
cityThe city of the registered address.Yes
stateThe state or province of the registered address. If the address doesn't contain state, city can be repeated as state.Yes
countryThe country of the registered address. Use Fetch Corporate Constants requests with category= countryName for a valid set of values.Yes
postcodeThe postal code where the corporate customer is registered.Yes

businessAddress object

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

* This object is not required if businessDetails.additionalInfo.isSameBusinessAddress = Yes.

PropertyDescriptionRequired
addressLine1The first address line of the business address.Yes *
addressLine2The second address line of the business address.No
cityThe city of the business address.Yes *
stateThe state or province of the business address. If the address doesn't contain state, city can be repeated as state.Yes *
countryThe country of the business address. Use Fetch Corporate Constants requests with category=countryName for a valid set of values.Yes *
postcodeThe postal code where the business address.Yes *

documentDetails object

An array of objects within the businessDetails object that contains one or more business documents.

* For a complete list of required documents, see EU required documents.

PropertyDescriptionRequired
documentTypeThe type of business document such as Business Registration Document or Association Deed. Use Fetch Corporate Constants requests with category= documentType for a valid set of values.Yes *
documentAn array of objects that contains a copy of the document.Yes *

document object

An array object within the businessDetails.documentDetails object. You can add multiple files under the same document object such as multiple pages of the Business Registration Document or addendum.

PropertyDescriptionRequired
fileNameThe name of the file.Yes *
fileTypeThe type of the file. Valid types are application/pdf, image/jpeg, image/jpg, image/png, jpeg, jpg, and png.Yes *
documentThe file as a base64 encoded string.Yes *

additionalInfo object

An object within the businessDetails object that contains additional information about the business.

PropertyDescriptionRequired
isSameBusinessAddressThis field accepts Yes or No to indicate if the principal place of business is the same or different from the registered business entity address. Note: Business address can be skipped if this field is YesNo
searchIdThis field is required for eKYB and is returned in the response of the Exhaustive Corporate Details using Business ID API. Required documents for business will be dependent on this field.No

stakeholders object

An array of objects within the businessDetails object that contains the stakeholders of the corporate customers such as Directors or UBOs. Stakeholder can be a business entity or a natural person. For every stakeholder object, you need to send either the stakeholderDetails or the businessPartner parameters.

PropertyDescriptionRequired
referenceIdThe 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.No
stakeholderDetailsAn object that contains the details of the individual stakeholder.Yes
businessPartnerAn object that contains the details of the corporate stakeholder, if available.Yes *

stakeholderDetails object

An object within the stakeholders object that contains the details about an individual stakeholder (natural person). All the Signatories, Directors, UBOs, Trustees, Settlor, Partners as available in the Business registration document, or Register of Directors or Register of Shareholders have to be included in the application for all business Types.

How to add positions:
  • Directors: All the management directors need to be added as stakeholders. Board of directors are not required.
  • UBO: All shareholders owning more than 25% of share (directly or indirectly) should be tagged as UBOs. In case, no individual owns 25% of share (directly or indirectly) then the most senior director as per their position should be declared as UBO. In case no UBO is submitted, Nium’s team will identify the UBO. For sole traders, the owner should be declared as the UBO.
  • Signatory/Representative: Individual(s) that will conduct transactions or add additional users should be declared as a Signatory/ Representative. Applicant is considered as Representative by default and should be added as such and will be eligible for conducting transactions. Any other users can be added as representatives as well. It is recommended to send all the users as part of the application. These users can be added later as well by sending an email to usermanagement@nium.com. KYC of such users should be completed as directed.
  • Others: Other positions such as Partner/ Trustee / Settlor should be provided as applicable as per the Position mapping
PropertyDescriptionRequired
kycModeThe KYC mode for the individual stakeholder. Note: This field is required to be MANUAL_KYC if positions include SIGNATORY, REPRESENTATIVE, UBO, TRUSTEE, PARTNER. Else ignore this field.Yes*
firstNameThe first name of the individual stakeholder.Yes
middleNameThe middle name of the individual stakeholder.No
lastNameThe surname of the individual stakeholder.Yes
nationalityThe nationality of the individual stakeholder. Use Fetch Corporate Constants requests with category = countryName for a valid set of values.Yes
dateOfBirthThe date the individual stakeholder was born in the YYYY-MM-DD format. Date of birth cannot be a future date.Yes
birthCountryThe country of birth. Use Fetch Corporate Constants requests with category = countryName for a valid set of values.Yes
taxDetailsThe taxation details of the individual stakeholder. Note: This field is required if the position is UBO, TRUSTEE, or PARTNER.Yes *
professionalDetailsAn array of objects to accept the positions held by the stakeholder in the business of the corporate customer and details related to the positions held.Yes
addressAn object that contains the residential address of the individual stakeholder.Yes
contactDetailsAn object that contains the contact details of the individual stakeholder.No
documentDetailsAn object that contains the document details of the individual stakeholder. Note: This field is required if kycMode=MANUAL_KYC. Additionally, documentDetails are required for DIRECTORYes *
additionalInfoAn object that contains additional information required about the individual stakeholder such as isPEP.Yes
taxDetails array

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

* This object is required if the position includes UBO or TRUSTEE, or PARTNER.

PropertyDescriptionRequired
countryThe country where the stakeholder is paying taxes. Use Fetch Corporate Constants requests with category=countryName for a valid set of values.Yes *
taxNumberThe tax ID number for the corresponding country. Maximum 64 characters.Yes *
professionalDetails object

An array of objects within the businessDetails.stakeholders.stakeholderDetails object that contains the individual stakeholder's professional details. Very often an individual can hold more that one position such as DIRECTOR/ UBO and all applicable positions must be selected.

PropertyDescriptionRequired
positionThe position of the individual stakeholder such as UBO, DIRECTOR, SIGNATORY. Use Fetch Corporate Constants for a valid set of values with category=positionYes
sharePercentageThe share percentage of the individual stakeholder in the company. Sharepercentage should be a number between 0 and 100. Eg. 23.4 Note: This field is required if position is UBO or SHAREHOLDER. Else ignore.Yes *
positionStartDateThe date the individual stakeholder started the position of UBO. Note: This field is required if the position is UBO or TRUSTEE or PARTNER. Position start date cannot be a future date.Yes *
address object

An object within the businessDetails.stakeholders.stakeholderDetails object that contains the individual stakeholder's residential address.

PropertyDescriptionRequired
addressLine1The first address line of the individual stakeholder.Yes
addressLine2The second address line of the individual stakeholder.No
cityThe city or suburb of the individual stakeholder.Yes
stateThe state or province of the individual stakeholder. City can be passed as state if state is unavailable.Yes
countryThe country where the individual stakeholder resides. Use Fetch Corporate Constants requests with category = countryName for a valid set of values.Yes
postcodeThe postal code of the individual stakeholder.Yes
contactDetails object

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

PropertyDescriptionRequired
emailThe individual stakeholder's email address.No
contactNoThe contact phone number of the individual stakeholder.No
documentDetails object

An array of objects within the businessDetails.stakeholders.stakeholderDetails object that contains the individual stakeholder's document details.

Please note:

  • If kycMode is MANUAL_KYC, system will validate for required documents. As a result, stakeholders whose positions include SIGNATORY, REPRESENTATIVE, UBO, TRUSTEE, PARTNER will require docuemntDetails and documents objects.
  • Additionally, if position includes DIRECTOR, we will require the document number which means documentDetails object (that will include documentNumber , documentIssuanceCountry, documentExpiryDate) needs to be mandatorily provided. Document file (documentDetails.document object) is not required for the DIRECTOR position.
  • if additionalInfo.isPEP is Yes then SOURCE_OF_WEALTH should be submitted as a document.

* Note: Check EU required Documents for list of acceptable documents, their definitions and properties.

PropertyDescriptionRequired
documentTypeThe type of document. Use Fetch Corporate Constants requests with category=documentType for a valid set of values.Yes *
documentNumberThe identification number for the document.Yes *
documentIssuanceCountryThe country that issued the document. Use Fetch Corporate Constants requests with category=countryName for a valid set of values.Yes *
documentExpiryDateThe date the document expires in the YYYY-MM-DD format. Note: This is required only if documentType = PASSPORT. Expiry date cannot be a past date.Yes *
documentAn array of objects that contains a copy of a document. Document is required only if kycMode=MANUAL_KYC or for sending additional documents such as SOURCE_OF_WEALTH .Yes *
document object

An array of objects within the businessDetails.stakeholders.stakeholderDetails.documentDetails object that contains a copy of the individual stakeholder's document.

PropertyDescriptionRequired
fileNameThe name of the file.Yes *
fileTypeThe type of the file. Valid types are application/pdf, image/jpeg, image/jpg, image/png, jpeg, jpg, and png.Yes *
documentThe file as a base64 encoded string.Yes *
additionalInfo object

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

PropertyDescriptionRequired
isPepThis field accepts Yes or No to indicate if the individual stakeholder is a politically exposed person. If this field is Yes, it is recommended to submit SOURCE_OF_WEALTH as a document as this will, otherwise be requested via RFI.Yes

A PEP (Politically Exposed Person) is someone who holds a prominent public position or has held one in the recent past and, as a result, may be more vulnerable to being involved in bribery, corruption, or money laundering.

businessPartner

An object within the businessDetails.stakeholders object that contains the business details of the corporate stakeholder.

  • If the customer is a multilayered company with another corporate owning more than 25% of share directly or indirectly then all such corporate stakeholders should be declared in the application.
  • Refer Multi-layered ownership structure to understand if the customer is a multi-layered company.
  • Additionally, Corporate Structure (or ownership structure) should be submitted to validate the structure under businessDetails.documentType = CORPORATE_STRUCTURE. Refer to EU Required documents.
PropertyDescriptionRequired
businessNameThe registered business name of the corporate stakeholder.Yes
businessRegistrationNumberThe business registration number.Yes
businessEntityTypeThe primary position of the corporate stakeholder in the business of the company. Use Fetch Corporate Constants requests with category = position for a valid set of values. Corporate stakeholders can typically hold positions such as UBO, SHAREHOLDER, PARTNER, TRUSTEE. Sometimes, corporate stakeholder can be a DIRECTOR as well.Yes
sharePercentageThe share percentage of the corporate stakeholder in the company.
Note: This field is required if the stakeholder’s position is UBO or SHAREHOLDER. Else ignore. Sharepercentage should be a number between 0 and 100. Eg. 23.4
Yes *
legalDetailsAn object that contains the registration and legal details of the corporate stakeholder.Yes

legalDetails object

Contains registration and legal information for the business.

PropertyDescriptionRequired
registeredCountryThe country where the corporate stakeholder is registered. Use Fetch corporate constants API with category = countryName for a valid selection.Yes

applicantDetails object

Contains details about the individual applicant representing the corporate customer.

PropertyDescriptionRequired
referenceIdA UUID associated with the applicant.No
kycModeThe KYC mode for verifying the identity of the applicant. Set kycMode : E_DOC_VERIFY.Yes
firstNameThe applicant’s first name. Maximum: 40 alphabetic characters or spaces.Yes
middleNameThe applicant’s middle name. Maximum: 40 alphabetic characters or spaces.No
lastNameThe applicant’s last name. Maximum: 40 alphabetic characters or spaces.Yes
nationalityThe applicant’s nationality (e.g., US, IN). Use the Fetch Corporate Constants request with category : countryName.Yes
dateOfBirthThe applicant’s date of birth. Format: YYYY-MM-DD. Cannot be a future date. Must be at least 18 years old.Yes
birthCountryThe applicant’s country of birth.
Required if the applicant’s position is UBO, TRUSTEE, or PARTNER. Use the Fetch Corporate Constants request with category : countryName.
Yes *
professionalDetailsArray of objects that describe the applicant’s roles in the business.Yes
taxDetailsThe applicant’s tax identification details.
Required if position is UBO, TRUSTEE, or PARTNER.
Yes *
addressThe applicant’s residential address.Yes
contactDetailsContact details for the applicant.Yes
documentDetailsOptional. An array of additional documents for the applicant (e.g., POWER_OF_ATTORNEY, SOURCE_OF_WEALTH).Yes *
additionalInfoAdditional applicant information, such as isPEP.Yes

professionalDetails object

Describes the roles held by the applicant in the corporate customer’s business.

PropertyDescriptionRequired
positionThe position of the applicant. Use Fetch corporate constants API for a valid set of values. An applicant is a REPRESENTATIVE by default. In addition, all applicable positions like UBO or DIRECTOR should be added.Yes
sharePercentageThe share percentage of the applicant in the company. Number between 0 and 100 Note: This field is required if the position is UBO/ SHAREHOLDERYes *
positionStartDateThe date the applicant started the position at the corporate customer. Position start date cannot be a future date. This field is required for UBO/ TRUSTEE/ PARTNER.Yes *
taxDetails array

An array of objects within the businessDetails.applicantDetails. object that contains the applicant's tax details of one or more countries.

* This object is required if the position includes UBO or TRUSTEE, or PARTNER.

PropertyDescriptionRequired
countryThe country of the applicant's tax paying country. Use Fetch Corporate Constants requests with category=countryName for a valid set of values.Yes *
taxNumberThe tax ID number for the corresponding country. Maximum 64 characters.Yes *

address object

An object within the businessDetails.applicantDetails object that contains the applicant's residential address.

PropertyDescriptionRequired
addressLine1The first address line of the applicant. The maximum character length is 40.Yes
addressLine2The second address line of the applicant. The maximum character length is 40.No
cityThe city of the applicant. The maximum character length is 20.Yes
stateThe state of the applicant. The maximum character length is 30.Yes
countryThe country where the applicant residence. Use Fetch Corporate Constants for category=countryName for a valid set of values.Yes
postcodeThe postal code of the applicant. The minimum length is 3 and the maximum is 10 alphanumeric characters or spaces.Yes

contactDetails object

An object within the businessDetails.applicantDetails object that contains the applicant's contact information.

PropertyDescriptionRequired
emailThe applicant's email address. The maximum character length is 40 and needs to be a valid email address. See Email regex.Yes
countryCodeThe country code of the applicant's phone number.Yes
contactNoThe applicant's phone number. The maximum length is 20 numeric characters.Yes

documentDetails object

An array of objects within the businessDetails.applicantDetails object that contains the applicant's document information. documentType and the document object are required for applicant in the below conditions:

  • If positions does not include DIRECTOR / UBO / PARTNER / TRUSTEE then POWER_OF_ATTORNEY is required.
  • If isPEP=Yes then SOURCE_OF_WEALTH is required.

* Check EU required Documents) for list of acceptable documents, their definitions and properties.

PropertyDescriptionRequired
documentTypeThe type of document. Use Fetch Corporate Constants for a valid set of values.Yes
documentThe copy of the document. Note: This is required for POWER_OF_ATTORNEY. This field is an array.Yes *
document object

An array of objects within the businessDetails.applicantDetails.documentDetails object that contains a copy of the document.

* This object is required for POWER_OF_ATTORNEY or SOURCE_OF_WEALTH.

PropertyDescriptionRequired
fileNameThe name of the file.Yes *
fileTypeThe type of the file. Valid types are application/pdf, image/jpeg, image/jpg, image/png, jpeg, jpg, and png.Yes *
documentThe copy of the document.Yes *

additionalInfo object

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

PropertyDescriptionRequired
isPepThis field accepts Yes or No to indicate if the applicant is a politically exposed person. If this field is Yes, it is recommended to submit SOURCE_OF_WEALTH as a document as this will, otherwise be requested via RFI.Yes

See PEP definition

expectedAccountUsage object

This object contains the details regarding the expected usage of the account

PropertyDescriptionRequired
debitObject containing expected account usage of all outward transactions.Yes
creditObject containing expected account usage of all inward transactions.Yes
intendedUsesArray of intended uses of the account. Send all applicable values. Use Fetch Corporate Constants with category = intendedUses for valid values.Yes
intendedUsesDescriptionText field description of the intended use of the account of the corporate customer if other is passed in the intendedUses field. Min 20 characters.Yes*

debitobject

This object containing expected account usage of all outward transactions

PropertyDescriptionRequired
monthlyTransactionVolumeEstimated total monthly payout transaction amount converted to EUR. Use Fetch Corporate Constants requests with category=monthlyTransactionVolume for a valid set of values.Yes
monthlyTransactionsEstimated count of payout transactions per month for the corporate customer. Use Fetch Corporate Constants requests with category=monthlyTransactions for a valid set of values.Yes
averageTransactionValueEstimated average transaction value per payout for the corporate customer converted to EUR. Use Fetch Corporate Constants requests with category=annualTurnover for a valid set of values.Yes
topTransactionCountriesArray of top payout countries. Use Fetch Corporate Constants requests with category= countryName for a valid set of values.Yes
topBeneficiariesArray of expected primary beneficiaries. Can be specific companies or types of entities (e.g., Ryan Air, Ketan Meheta, Employees of corporate).Yes

creditobject

This object containing expected account usage of all inward transactions.

* In case the customer is not enabled for payins, the client is expected to send the minimum bracket within the allowed ranges for monthlyTransactionVolume, monthlyTransactions, averageTransactionValue.

PropertyDescriptionRequired
monthlyTransactionVolumeEstimated total monthly payin transaction amount converted to EUR. Use Fetch Corporate Constants requests with category=monthlyTransactionVolume for a valid set of values.Yes
monthlyTransactionsEstimated count of payin transactions per month for the corporate customer. Use Fetch Corporate Constants requests with category=monthlyTransactions for a valid set of values.Yes
averageTransactionValueEstimated average transaction value per payin for the corporate customer converted to EUR. Use Fetch Corporate Constants category=annualTurnover for a valid set of values.Yes
topTransactionCountriesArray of top payin countries. Use Fetch Corporate Constants requests with category= countryName for a valid set of values.Yes
topRemittersArray of expected primary remitters. Can be specific companies or types of entities (e.g., Ryan Air, Ketan Meheta, Employees of corporate).Yes

natureOfBusiness object

An object within the businessDetails.natureOfBusiness object to provide the nature of business such as industrySector.

* If the industrySector contains any prohibited industries, additional documentation might be requested and can affect the overall approval TAT. Refer to Prohibited and Restricted Business Categories

PropertyDescriptionRequired
industryCodesAn array of industry sector codes that apply for the corporate customer's business. Send all applicable values. Use Fetch Corporate Constants for a valid set of values using industrySector categoryYes
industryDescriptionText field explaining the business of the corporate customer in 2-3 sentences. Max Character limit: 300. Min 20 characters.Yes

riskAssessmentInfo object

An object that contains the details related to the business profile of the corporate customers.

PropertyDescriptionRequired
totalEmployeesThe corporate customer's total number of employees. Use Fetch Corporate Constants requests with category=totalEmployees for a valid set of values.Yes
annualTurnoverThe corporate customer’s annual turnover.If the company is less than one year old, provide the expected turnover; otherwise, provide the turnover from the previous year. Turnover refers to the total revenue generated by the business.
Use Fetch Corporate Constants with category = annualTurnover for a valid set of values.
Yes
countryOfOperationAn array of all the countries the corporate customer has presence and does business. List all the countries you have branches, operations, factories etc… Use Fetch Corporate Constants for a valid set of values. This field is an array. Ex: ["IN", "FR", "LT"]Yes

deviceDetails object

This object contains the information about the customer's device and IP address where the onboarding request originated.

PropertyDescriptionRequired
countryIPCountry of the IP address e.g. US. Use Fetch Corporate Constants requests with category = countryName for valid values.Yes
deviceInfoInformation of the device e.g. Mac OS.Yes
ipAddressIP address of the device e.g. 45.48.241.198Yes
sessionIdA unique identifier for the session, generated by your application.Yes

tags object

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

PropertyDescriptionRequired
keyThe name of the tag. The maximum character length is 128. Key should be unique.No
valueThe value of the tag. The maximum character length is 256.No