Skip to main content

​
Creating a Business User — Field Values Reference

When you create a business user (POST /api/v1/account/business-user), several fields only accept a constrained set of values. This guide explains where each value comes from so your request doesn’t get rejected with a validation error. There are two kinds of constrained fields:
  • Fixed enums — a closed list defined by the API. The valid values are shown in the request schema of the Create business user endpoint, and listed here for convenience.
  • Dynamic catalogs — values that live in a reference endpoint you must query first. You cannot hardcode these; always fetch the current list.

​
Fixed enums

These values are part of the API contract. Send them exactly as written (uppercase, underscore-separated).

​
company.incorporation.constitutionType

The legal structure of the company.
Important: When you send OTHER, also fill constitutionTypeOther with a free-text description.

​
businessActivity.industryType

Important: When you send OTHER, also fill industryTypeOther with a free-text description.

​
businessActivity.expectedMonthlyVolume

​
Dynamic catalogs

​
Country fields — ISO 3166-1 alpha-2

Every country field — company.incorporation.country, company.addresses.registered.country, company.addresses.operational.country, company.contact.phoneNumberCountry, company.contact.mobileCountryCode, and any country inside businessActivity.fundsFlow — expects a 2-letter ISO 3166-1 alpha-2 code (e.g. ES, US, FR). To get the list of countries Ralio supports, query:
See List countries.

​
Free-text fields

The following fields are not enums — they accept free text and have no catalog to query:
  • businessActivity.businessNature
  • businessActivity.revenueModel
  • businessActivity.productsAndServices
Note: Percentages in businessActivity.revenueBreakdown and in businessActivity.fundsFlow (inwards/outwards) must each sum to 100.