Germany guide

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.

EnvironmentBase 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 Germany

EnvironmentURL
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

ParametersDescription
companyTypeGmbhUg EK Gewerbebetrieb GbrOhg Gbr eGbR OHG KG
companyNumberHandelsregisternummer, usually has the format HRA12345
mobilePhoneNumberThe format for this parameter is: +49xxxxxxxxxxx
countryISOCodeDEU
loanCurrencyISOCodeEUR

companyType mappings for Germany

NameLong NameYouLend MappingCompany Number Expected
GmbhGesellschaft mit beschränkter HaftungGmbhUgYes
AGAktiengesellschaftGmbhUgYes
UGUnternehmergesellschaft (haftungsbeschränkt)GmbhUgYes
OHGoffene HandelsgesellschaftOHGYes
KGKommanditgesellschaftKGYes
GbRGesellschaft bürgerlichen RechtsGbrNo
KGaAKommanditgesellschaft auf AktienKGYes
eGeingetragene GenossenschafteGbRYes
(Solo)Selbständige / (Klein)Gewerbetreibende, FreelancerEinzelunternehmer mit GewerbeanmeldungGewerbebetriebNo
LtdLimitedGmbhUgYes
PartGPartnerschaftsgesellschaftGbrOhgYes/No
Freiberufler (ohne Gewerbeanmeldung)Katalogberufe und katalogähnliche Berufe (Ärzte, Rechtsanwälte, Ingenieure, etc)GewerbebetriebNo
SEEuropäische Aktiengesellschaft (SE)GmbhUgYes
e. V.eingetragener VereineGbRYes
GmbH & Co. KGGesellschaft mit beschränkter Haftung & Compagnie KommanditgesellschaftGmbhUgYes
e. K.eingetragener KaufmannEKYes
UG & Co. KGDie Unternehmergesellschaft (haftungsbeschränkt) & Co. KGGmbhUgYes
gGmbHgemeinnützige Gesellschaft mit beschränkter HaftungGmbhUgYes
gUGgemeinnützige Unternehmergesellschaft (haftungsbeschränkt)Charity (Youlend can't fund)N/a
K.d.ö.R.Körperschaft des öffentlichen RechtsCharity (Youlend can't fund)N/a

Example Create Lead Request

{
  "thirdPartyCustomerId": "16d81dac",
  "confirmedCreditSearch": true,
  "countryISOCode": "DEU",
  "loanCurrencyISOCode": "EUR",
  "keyContactName": "Sophie Allard",
  "companyType": "GmbhUg",
  "companyName": "Test Company",
  "companyNumber": "HRA12345",
  "registeredAddress": {
    "line1": "5 Happy Road",
    "city": "Berlin",
    "areaCode": "99998",
    "country": "Germany"
  },
  "contactPhoneNumber": "+4900000000000",
  "contactEmailAddress": "[email protected]",
  "preferredLanguageCode": "de",
  "confirmedCreditSearch": true
}