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
| 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 |
companyType mappings for Netherlands
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
}