Belgium

For full country-specific configuration details, including enum values, field formats, and validation rules, refer to the Belgium Localisation Guide section.

Company Types

For Belgium, companyType must be one of the exact API enum values accepted by the Create Lead endpoint. Do not send translated legal-form labels unless they are listed as accepted enum values.

Belgian Legal Form	Accepted `companyType` value	Description
Eenmanszaak / Entreprise Individuelle	`Eenmanszaak`	Sole Trader
BV / SRL	`Bv`	Private Limited Company
CV / SComm	`Cv`	Limited Partnership
NV / SA	`Nv` or `SA`	Public Limited Company
VoF / SNC	`Vof` or `SNC`	General Partnership
SCS	`SCS`	Limited Partnership, where applicable
Societe Cooperative	`SocieteCooperative`	Cooperative company

SRL, SComm, and EntrepriseIndividuelle are legal-form labels, but they are not accepted by the Create Lead endpoint as companyType values. Use Bv, Cv, and Eenmanszaak respectively.

Create Lead for Belgium

Here's a complete example of creating a lead for a Belgian company using the Onboarding API:

{
  "thirdPartyCustomerId": "BE_CUSTOMER_12345",
  "confirmedCreditSearch": true,
  "countryISOCode": "BEL",
  "loanCurrencyISOCode": "EUR",
  "keyContactName": "Jean Dupont",
  "companyType": "Bv",
  "companyName": "Chocolaterie Belge BV",
  "tradingName": "Chocolaterie Belge",
  "companyNumber": "0789123456",
  "companyWebsite": "www.chocolaterie-belge.be",
  "registeredAddress": {
    "line1": "Rue de la Chocolaterie 25",
    "city": "Brussels",
    "region": "Brussels-Capital Region",
    "areaCode": "1000",
    "country": "Belgium"
  },
  "contactPhoneNumber": "+32487654321",
  "contactEmailAddress": "[email protected]",
  "additionalInfo": {
    "youLendSales": "false",
    "language": "nl"
  }
}

Response

{
  "leadId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "leadURL": "string",
  "signUpURL": "string",
  "openBankingURL": "string"
}

The API will return a leadId that you can use for subsequent operations like uploading documents, updating organization details, or retrieving lead status.