Legal Entity — Fields & Validation

Authoritative validation rules for Legal entity onboarding fields.

Global character rules for name‑like fields

Exclude these special characters: < > { } [ ] } = % \ / ;
Accepted characters include common punctuation and diacritics used in real names, e.g. hyphen -, apostrophe ', accented letters (é, è, ô, …) and characters such as Ł or Ø.

Applies to: CompanyName, brandNames, shareholding name.

Legend

Type: data type expected by the API or form engine (e.g., string, enum, boolean).
Rules: constraints to validate on both client and server. For country codes, use ISO 3166‑1 alpha‑2 (see: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

Field reference

Core identity

Field	Type	Rules
CompanyName	string	Exclude `<>{[]}=%\\/;` · min 1 char · max 256 chars · typical name chars like `-`, `'`, diacritics (é, è, ô…), and letters like Ł/Ø allowed
brandNames	string	Exclude `<>{[]}=%\\/;` · min 1 char · max 256 chars
legalEntityType	enum	One of predefined values Company Association Sole_Trader
legalForm	enum	One of predefined values (see list below)
registrationNumber	string	Alphanumeric
registrationDate	date (DD/MM/YYYY)	Cannot be today or future date
vatNumber	string	Alphanumeric
website	string (URL)	Must match a website/URL pattern (accept `http://`, `https://`, or `www.` prefixes)
NoWebsiteReason	string	min 1 char · max 256 chars

Registered address

Field	Type	Rules
Registration Street	string	min 1 char · max 256 chars
Registration ComplementaryStreetInfo	string	min 1 char · max 256 chars
Registration PostalCode	string (alphanumeric)	min 1 char · max 90 chars
Registration City	string	min 1 char · max 90 chars
Registration Province (Applies to Italy)	enum	One of predefined values
Registration country	string (ISO 3166‑1 alpha‑2)	Two‑letter country code

Trading address

Field	Type	Rules
Trading Street	string	min 1 char · max 256 chars
Trading ComplementaryStreetInfo	string	min 1 char · max 256 chars
Trading PostalCode	string (alphanumeric)	min 1 char · max 90 chars
Trading City	string	min 1 char · max 90 chars
Trading Province (Applies to Italy)	enum	One of predefined values
Trading country	string (ISO 3166‑1 alpha‑2)	Two‑letter country code

Classification & activity

Field	Type	Rules
activityNACE	enum	One of predefined values (NACE Rev.2 code, e.g., `25.73`)
AtecoCode	enum	One of predefined values
SaeCode	enum	One of predefined values
companyObject	string	max 256 chars

Enum: `legalForm`

Provide one of the following values (machine values shown): SOLE_TRADER, SELF_EMPLOYED, LEGAL_ENTITY_UNDER_FOREIGN_LAW_REGISTERED_WITH_THE_RCS, ANSTALT, LEGAL_ENTITY_UNDER_FOREIGN_LAW_NOT_REGISTERED_WITH_THE_RCS, CONDOMINIUM, INDIVISION_CO_OWNERSHIP, DE_FACTO_COMPANY, PARTNERSHIP, TRUSTS, OTHER_PRIVATE_LAW_GROUPING_NOT_ENDOWED_WITH_LEGAL_PERSONALITY, SPECIAL_COMMERCIAL_COOPERATIVE_COMPANY, GENERAL_PARTNERSHIP, LIMITED_PARTNERSHIP, LIMITED_LIABILITY_COMPANY, PROFESSIONAL_LIMITED_LIABILITY_COMPANY, PUBLIC_LIMITED_COMPANY_WITH_BOARD_OF_DIRECTORS, PUBLIC_LIMITED_COMPANY_WITH_MANAGEMENT_BOARD, SIMPLIFIED_JOINT_STOCK_COMPANY, FINANCIAL_PARTICIPATION_COMPANY_OF_LIBERAL_PROFESSIONS, PROFESSIONAL_COMPANY_WITH_SIMPLIFIED_JOINT_STOCK_STRUCTURE, EUROPEAN_COMPANY, SAVINGS_AND_PROVIDENT_FUND, COLLECTIVE_INVESTMENT_SCHEME_IN_SECURITIES_WITHOUT_LEGAL_PERSONALITY, MUTUAL_INSURANCE_COMPANY, ECONOMIC_INTEREST_GROUP, AGRICULTURAL_COOPERATIVE, FOUNDATION_STICHTING, COLLECTIVE_INVESTMENT_SCHEME, AGRICULTURAL_COLLECTIVE_INTEREST_COMPANY, REAL_ESTATE_COMPANY, REAL_ESTATE_CIVIL_COMPANY, REAL_ESTATE_CONSTRUCTION_AND_SALE_CIVIL_COMPANY, ALLOCATION_CIVIL_COMPANY, PROGRESSIVE_PROPERTY_ACCESS_REAL_ESTATE_CIVIL_COMPANY, COOPERATIVE_CIVIL_CONSTRUCTION_COMPANY, COOPERATIVE_CIVIL_CONSUMPTION_COMPANY, COOPERATIVE_CIVIL_MARITIME_INTEREST_COMPANY, COOPERATIVE_CIVIL_COMPANY_AMONG_DOCTORS, OTHER_COOPERATIVE_CIVIL_COMPANY, PROFESSIONAL_CIVIL_COMPANY, PUBLIC_INSTITUTION_OR_INDUSTRIAL_AND_COMMERCIAL_ENTITY, STATE_ADMINISTRATION, TERRITORIAL_AUTHORITY, ADMINISTRATIVE_PUBLIC_INSTITUTION, PUBLIC_OFFICE_FOR_LOW_COST_HOUSING, LOCAL_CULTURAL_PUBLIC_INSTITUTION, ORGANIZATION_MANAGING_COMPULSORY_MEMBERSHIP_SOCIAL_PROTECTION_SYSTEM, MUTUAL_ORGANIZATION, WORKS_COUNCIL, EMPLOYEE_UNION, EMPLOYERS_UNION, PROFESSIONAL_ORDER_OR_EQUIVALENT

Funding & turnover

Field	Type	Rules
sameFundCountryAsCompanyRegistration	boolean	`true` or `false`
sameFundCountryAsCompanyRegistration.reason	string	min 1 char · max 256 chars (required when above is `false`, if business rule applies)
sameFundCountryAsCompanyRegistration.countries	list of string (ISO 3166‑1 alpha‑2)	One or more two‑letter country codes
ExpectedActivityVolume	enum	One of predefined values (see list below)
PreviousTurnover	enum	One of predefined values (see list below)
CurrentTurnover	enum	One of predefined values (see list below)
FinancialAssets	enum	One of predefined values (see list below)

Enum: `ExpectedActivityVolume` (`FIRST_TIER` … `SEVENTH_TIER`)

FIRST_TIER → 0 – 120K €
SECOND_TIER → >120K € – 500K €
THIRD_TIER → >500K € – 2M €
FOURTH_TIER → >2M € – 5M €
FIFTH_TIER → >5M € – 20M €
SIXTH_TIER → >20M € – 100M €
SEVENTH_TIER → >100M €

Enum: `CurrentTurnover` & `PreviousTurnover` (same scale)

FIRST_TIER → 0 – 120K €
SECOND_TIER → >120K € – 500K €
THIRD_TIER → >500K € – 2M €
FOURTH_TIER → >2M € – 5M €
FIFTH_TIER → >5M € – 20M €
SIXTH_TIER → >20M € – 100M €
SEVENTH_TIER → >100M €

Enum: `FinancialAssets`

FIRST_TIER → 0 – 200K €
SECOND_TIER → >200K € – 1M €
THIRD_TIER → >1M € – 5M €
FOURTH_TIER → >5M € – 15M €
FIFTH_TIER → >15M € – 50M €
SIXTH_TIER → >50M € – 200M €
SEVENTH_TIER → >200M €

Origin of funds & financing

Field	Type	Rules
originOfFunds.sources	enum	One of predefined values (see list below)
originOfFunds.other	string	min 1 char · max 256 chars (use when source = `OTHER_OPERATIONS`)
EntityFinancing.by	enum	One of predefined values (see list below)
EntityFinancing.Other	string	min 1 char · max 256 chars (use when financing = `other`)

Enum: `originOfFunds.sources`

Legal entity (company) values — machine values (front labels in italics when applicable):

REAL_ESTATE_PROPERTIES — Real estate properties
EXCESS_CASH_RESERVES — Excess cash reserves
SALE_OF_A_STOCK_PORTFOLIO — Sale of a stock portfolio
TRANSFER_OR_SALE_OF_COMPANY_SHARES — Transfer or sale of company shares
SURRENDER_OF_A_CAPITALIZATION_CONTRACT — Surrender of a capitalization contract
SHAREHOLDER_CURRENT_ACCOUNT_CONTRIBUTIONS — Shareholder current account contributions
SALE_OF_MOVABLE_ASSETS — Sale of movable assets (car, boat, artwork, etc.)
FINANCIAL_INVESTMENTS — Financial investments
OTHER_OPERATIONS — Other operations (please specify)

Note: Individuals have a different list for originOfFunds.sources. This page documents Legal entity enums.

When originOfFunds.sources = OTHER_OPERATIONS, originOfFunds.other becomes required.

Enum: EntityFinancing.by

Legal entity (association) values** — machine values (front labels in italics when applicable):

donation — Donation
membership fees — Membership fees
subvention — Subvention
other — Other (please specify)

Shareholding

Field	Type	Rules
shareholding name	string	Exclude `<>{[]}=%\\/;` · min 1 char · max 256 chars
shareholding country	string (ISO 3166‑1 alpha‑2)	Two‑letter country code
shareholding number	string	Alphanumeric

Project & risk flags

Field	Type	Rules
projectDescription	string	min 1 char · max 256 chars
projectWebsite	string (URL)	Must match a website/URL pattern (accept `http://`, `https://`, or `www.` prefixes)
performsProhibitedActivity (debtor)	boolean	`true` or `false`
locatedInHighriskCountry (debtor)	boolean	`true` or `false`

Implementation notes

Country codes: Validate against the ISO 3166‑1 alpha‑2 set (e.g., FR, IT, DE). Reference: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2.
Dates: Parse as DD/MM/YYYY. Reject today’s date and any future date for registrationDate.
URLs: Accept schemes http or https, and bare www. prefixes. Consider IDN domains and punycode if applicable in your stack.
Conditional requirements: Where noted (e.g., sameFundCountryAsCompanyRegistration.reason), enforce only when the related toggle dictates.