Corporate Constants

The Fetch Corporate Constants request returns acceptable values of various fields that need to be passed via the Onboard Corporate Customer request.

Constants endpoint

Some of the enumerated fields have values that change often as they're added or removed, such as intendedUseOfAccount or industrySector. Integrating this request helps you cater to these changes without the need for any further development on your end.

Keeping enumerated values up to date is beneficial to the customers as it improves the application approval rates and reduces the turnaround time for approvals.

You need to integrate this API as part of your onboarding process. You need to also display its output to your customers as a dropdown list while they complete your onboarding form. Use this API for all the fields listed below.

fieldName to category

Pass the fieldName as the category listed in the table below.

The following are the categories in Fetch Corporate Constants API.

Fetch Corporate Constants API category	Onboard Corporate Customer API fieldName
annualTurnover	riskAssessmentInfo.annualTurnover
averageTransactionValue	expectedAccountUsage.debit.averageTransactionValue expectedAccountUsage.credit.averageTransactionValue
businessType	businessDetails.businessType businessDetails.stakeholders.businessPartner.businessType
capitalContribution	businessDetails.stakeholders.stakeholderDetails.professionalDetails.capitalContribution businessDetails.stakeholders.businessPartner.capitalContribution businessDetails.applicantDetails.professionalDetails.capitalContribution
countryName	businessDetails.addresses.businessAddress.country businessDetails.addresses.registeredAddress.country businessDetails.applicantDetails.address.country businessDetails.applicantDetails.documentDetails.documentIssuanceCountry businessDetails.applicantDetails.taxDetails.country businessDetails.businessPartner.addresses.registeredAddress.country businessDetails.businessPartner.legalDetails.registeredCountry businessDetails.documentDetails.documentIssuanceCountry businessDetails.legalDetails.registeredCountry businessDetails.partnershipDetails.partnerCountry businessDetails.stakeholders.stakeholderDetails.address.country businessDetails.stakeholders.stakeholderDetails.documentDetails.documentIssuanceCountry businessDetails.taxDetails.country riskAssessmentInfo.countryOfOperation riskAssessmentInfo.transactionCountries businessDetails.applicantDetails.nationality expectedAccountUsage.debit.topTransactionCountries expectedAccountUsage.credit.topTransactionCountries
countryOfOperation	riskAssessmentInfo.countryOfOperation riskAssessmentInfo.transactionCountries
documentType	businessDetails.documentType businessDetails.stakeholders.stakeholderDetails.documentType businessDetails.applicantDetails.documentType
intendedUseOfAccount	riskAssessmentInfo.intendedUseOfAccount expectedAccountUsage.intendedUses
industrySector	riskAssessmentInfo.industrySector
listedExchange	businessDetails.legalDetails.listedExchange
monthlyTransactionVolume	expectedAccountUsage.debit.monthlyTransactionVolume expectedAccountUsage.credit.monthlyTransactionVolume
monthlyTransactions	expectedAccountUsage.debit.monthlyTransactions expectedAccountUsage.credit.monthlyTransactions
position	businessDetails.stakeholders.stakeholderDetails.position businessDetails.stakeholders.businessPartner.businessEntityType businessDetails.applicantDetails.position
regulatedTrustType	businessDetails.regulatoryDetails.regulatedTrustType \* Valid only for AU
restrictedCountries	riskAssessmentInfo.restrictedCountries \* Required for the UK
state	businessDetails.addresses.registeredAddress.state businessDetails.addresses.businessAddress.state businessDetails.stakeholders.stakeholderDetails.address.state businessDetails.addresses.applicantDetails.address.state \* Valid only for US, AU, NZ addresses.
streetType	businessDetails.stakeholders.stakeholderDetails.address.state businessDetails.addresses.applicantDetails.address.state \* Valid only for AU, NZ addresses.
totalEmployees	riskAssessmentInfo.totalEmployees
trustBeneficiaryClass	businessDetails.stakeholders.stakeholderDetails.professionalDetails.trustBeneficiaryClass \* Valid only for NZ
unregulatedTrustType	businessDetails.regulatoryDetails.unregulatedTrustType
votingRights	businessDetails.stakeholders.stakeholderDetails.professionalDetails.votingRights
rfiTemplates	This can be used to find the templateId to template name mapping for RFI templates of different regions.

Response

The API response contains an array of code-description pairs that are valid for the given field.

Response field	Usage
code	The valid values that need to be used in the Onboard Corporate Customer request for the given field.
description	A description of the category code which can be shown to the applicant as a dropdown list.