Netherlands

Authentication and environments

Base URLs for the EU platform (when interacting with YouLends APIs)

When interacting with our EU specific endpoints, please use the below URLs.

Environment	Base URL
EU (production)	`https://youlendapi.com`
EU (staging)	`https://partners.staging-youlendapi.com`

Authentication URLs (to request an access token)

📘
Good to know
Please visit our Authentication guide for more information regarding authenticating in Netherlands

Environment	URL
EU (production)	`https://youlend.eu.auth0.com/oauth/token`
EU (staging)	`https://youlend-stag.eu.auth0.com/oauth/token`

Onboarding APIs

This section focuses on all APIs that partners can interact with when onboarding a merchant.

Parameter callouts

Create a lead

Parameters	Description
`companyType`	`Eenmanszaak` `BV` `CV` `VoF` `NV`
`companyNumber`	8-digit KVK number (submit stage 1 will return an error if this param is not provided)
`mobilePhoneNumber`	The format for this parameter is: `+32xxxxxxxxx`
`countryISOCode`	`NLD`
`loanCurrencyISOCode`	`EUR`

Update Significant Persons

Address Object

Parameters	Description
`line1`	The format for this parameter is: [road name] [number]. Example: Test Road 24
`nationality`	This should be the name of the nationality Example: Dutch Not accepted: ISO codes
`country`	This should be the name of the country Example: Netherlands Not accepted: ISO codes

`companyType` mappings for Netherlands

Name	YouLend Mapping	Company Number Expected	Supported by YouLend
Eenmanszaak	`Eenmanszaak`	✅ Yes	✅ Yes
Besloten vennootschap	`BV`	✅ Yes	✅ Yes
Vennootschap onder firma	`VoF`	✅ Yes	✅ Yes
Maatschap	`VoF`	✅ Yes	✅ Yes
Commanditaire vennootschap	`CV`	✅ Yes	✅ Yes
Naamloze venootschap	`NV`	✅ Yes	✅ Yes
Stichting	N/A	N/A	❌ No
Vereniging	N/A	N/A	❌ No
Self-employed /Freelancer	`SoleTrader`	❌ No	✅ Yes
Vestiging	N/A	N/A	❌ No
Europees Economisch Samenwerkingsverband (EESV)	`BV`	✅ Yes	✅ Yes
European Company (SE)	`BV`	✅ Yes	✅ Yes

Example request

{
  "thirdPartyCustomerId": "16d81dac",
  "confirmedCreditSearch": true,
  "countryISOCode": "NLD",
  "loanCurrencyISOCode": "EUR",
  "keyContactName": "Carl Jensen",
  "companyType": "Eenmanszaak",
  "companyName": "Test Company",
  "companyNumber": "18357486",
  "registeredAddress": {
    "line1": "5 Happy Road",
    "city": "Amsterdam",
    "areaCode": "1078BA",
    "country": "NLD"
  },
  "contactPhoneNumber": "+3200000000",
  "contactEmailAddress": "[email protected]",
  "preferredLanguageCode": "nl",
  "confirmedCreditSearch": true
}

Updated about 1 month ago