Fetch Corporate Constants API

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

API usage

Some of the enumerated fields have values that change often as they're added or removed, such as intendedUseOfAccount or industrySector. Integrating this API 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.

Response

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

Deprecated values

Some of the previously supported values in the following fields are deprecated to support a new risk model and will not be available from September 2, 2023. Update the acceptable values using Fetch Corporate Constants API. After updated, reach out to Nium Support for migration to the new risk model.

annualTurnover

These values are found in riskAssessmentInfo > annualTurnover

AU

Enum value	Description	Regulatory region
AU001	Less than AUD 10,000	AU __ __ __ __
AU002	AUD 10,000 to AUD 25,000	AU __ __ __ __
AU003	AUD 25,000 to AUD 50,000	AU __ __ __ __
AU004	AUD 50,000 to AUD 100,000	AU __ __ __ __
AU005	AUD 100,000 to AUD 250,000	AU __ __ __ __
AU006	AUD 250,000 to AUD 500,000	AU __ __ __ __
AU007	AUD 500,000+	AU __ __ __ __

EU

Enum value	Description	Regulatory region
EU001	Less than EUR 10,000	__ EU __ __ __
EU002	EUR 10,000 to EUR 25,000	__ EU __ __ __
EU003	EUR 25,000 to EUR 50,000	__ EU __ __ __
EU004	EUR 50,000 to EUR 100,000	__ EU __ __ __
EU005	EUR 100,000 to EUR 250,000	__ EU __ __ __
EU006	EUR 250,000 to EUR 500,000	__ EU __ __ __
EU007	EUR 500,000+	__ EU __ __ __

SG

Enum value	Description	Regulatory region
SG001	Less than SGD 10,000	__ __ SG __ __
SG002	SGD 10,000 to SGD 25,000	__ __ SG __ __
SG003	SGD 25,000 to SGD 50,000	__ __ SG __ __
SG004	SGD 50,000 to SGD 100,000	__ __ SG __ __
SG005	SGD 100,000 to SGD 250,000	__ __ SG __ __
SG006	SGD 250,000 to SGD 500,000	__ __ SG __ __
SG007	SGD 500,000+	__ __ SG __ __

UK (GB)

Enum value	Description	Regulatory region
GB001	Less than GBP 10,000	__ __ __ UK __
GB002	GBP 10,000 to GBP 25,000	__ __ __ UK __
GB003	GBP 25,000 to GBP 50,000	__ __ __ UK __
GB004	GBP 50,000 to GBP 100,000	__ __ __ UK __
GB005	GBP 100,000 to GBP 250,000	__ __ __ UK __
GB006	GBP 250,000 to GBP 500,000	__ __ __ UK __
GB007	GBP 500,000+	__ __ __ UK __

US

Enum value	Description	Regulatory region
US001	Less than USD 10,000	__ __ __ __ US
US002	USD 10,000 to USD 25,000	__ __ __ __ US
US003	USD 25,000 to USD 50,000	__ __ __ __ US
US004	USD 50,000 to USD 100,000	__ __ __ __ US
US005	USD 100,000 to USD 250,000	__ __ __ __ US
US006	USD 250,000 to USD 500,000	__ __ __ __ US
US007	USD 500,000+	__ __ __ __ US

industrySector

These values can be found in riskAssessmentInfo > industrySector

intendedUseOfAccount

These values can be found in riskAssessmentInfo > intendedUseOfAccount

totalEmployees

These values are found in riskAssessmentInfo > totalEmployees