---
title: "Update organisation details."
method: PUT
path: "/Leads/{leadId}/organisationdetails"
tags: ["Enrich an Application"]
---

# Update organisation details.

`PUT /Leads/{leadId}/organisationdetails`

## Request

- Base URL: `https://partners.staging-youlendapi.com/onboarding`
- URL: `https://partners.staging-youlendapi.com/onboarding/Leads/{leadId}/organisationdetails`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://youlend-stag.eu.auth0.com/oauth/token`

## Path parameters

- `leadId` string, uuid, required

## Headers

- `api-version` string

## Request body

- OnboardingOrganisationDetailsModel: Model for organisation details for a company.
  - `companyName` string, required: Gets or sets the merchant's company name.
  - `registeredAddress` AddressModel, required: Address Data Model.
    - `line1` string, required: Gets or sets Address Line 1.
    - `line2` string, nullable: Gets or sets Address Line 2.
    - `line3` string, nullable: Gets or sets Address Line 3.
    - `city` string, required: Gets or sets the City.
    - `region` string, nullable: Gets or sets the Region.
    - `areaCode` string, required: Gets or sets the Area Code.
    - `country` string, nullable: Gets or sets the Country. Cannot be null or empty if YL.Web.Api.ThirdParty.Onboarding.Models.AddressModel.CountryISOCode is not set. If both are set, we use YL.Web.Api.ThirdParty.Onboarding.Models.AddressModel.Country.
    - `countryISOCode` 'GBR' | 'IRL' | 'NLD' | 'BEL' | 'POL' | 'USA' | 'DEU' | 'FRA' | 'ESP' | 'DNK': Gets or sets the CountryISOCode. Cannot be null or empty if YL.Web.Api.ThirdParty.Onboarding.Models.AddressModel.Country is not set. If both are set, we use YL.Web.Api.ThirdParty.Onboarding.Models.AddressModel.Country.
  - `country` 'GBR' | 'IRL' | 'NLD' | 'BEL' | 'POL' | 'USA' | 'DEU' | 'FRA' | 'ESP' | 'DNK', required: Gets or sets the country for the company.
  - `formationDate` string, date-time: Gets or sets the formation date of the company.
  - `keyContactName` string, required: Gets or sets the key merchant contact who will be setting up the loan.
  - `contactPhoneNumber` string, required: Gets or sets the merchant's contact phone number.
  - `contactEmailAddress` string, email, required: Gets or sets the merchant's key contact email address.
  - `tradingAddress` AddressModel: Address Data Model.
    - `line1` string, required: Gets or sets Address Line 1.
    - `line2` string, nullable: Gets or sets Address Line 2.
    - `line3` string, nullable: Gets or sets Address Line 3.
    - `city` string, required: Gets or sets the City.
    - `region` string, nullable: Gets or sets the Region.
    - `areaCode` string, required: Gets or sets the Area Code.
    - `country` string, nullable: Gets or sets the Country. Cannot be null or empty if YL.Web.Api.ThirdParty.Onboarding.Models.AddressModel.CountryISOCode is not set. If both are set, we use YL.Web.Api.ThirdParty.Onboarding.Models.AddressModel.Country.
    - `countryISOCode` 'GBR' | 'IRL' | 'NLD' | 'BEL' | 'POL' | 'USA' | 'DEU' | 'FRA' | 'ESP' | 'DNK': Gets or sets the CountryISOCode. Cannot be null or empty if YL.Web.Api.ThirdParty.Onboarding.Models.AddressModel.Country is not set. If both are set, we use YL.Web.Api.ThirdParty.Onboarding.Models.AddressModel.Country.
  - `tradingName` string, nullable: Gets or sets the merchant's trading name.
  - `companyNumber` string, nullable: Gets or sets the registered company number.
  - `vatNumber` string, nullable: Gets or sets the VAT number for the company.
  - `companyType` 'Ltd' | 'Plc' | 'Llp' | 'SoleTrader' | 'Partnership' | 'Llc' | 'BusinessCorporation' | 'Dac' | 'Eenmanszaak' | 'Bv' | 'Cv' | 'Nv' | 'Vof' | 'NaamlozeVennootschap' | 'SpZoo' | 'SpkSpj' | 'Scspp' | 'SaSKA' | 'Jdg' | 'GmbhUg' | 'EK' | 'Gewerbebetrieb' | 'GbrOhg' | 'Gbr' | 'EGbr' | 'Ohg' | 'Kg' | 'Aktiengesellschaft' | 'SlSlne' | 'SociedadColectiva' | 'SociedadComanditaria' | 'EIAutonomo' | 'SociedadCivil' | 'SociedadCooperativa' | 'SARL' | 'EINomPropre' | 'SNC' | 'SocieteCooperative' | 'SA' | 'SAS' | 'EURL' | 'SCP' | 'SCS' | 'SASU' | 'AS' | 'ApS' | 'KS' | 'PS' | 'Fmba' | 'Andelsselskab' | 'Amba' | 'ErhvervsdrivendeFond' | 'IS' | 'Smba' | 'SI' | 'SelvstændigOffentligVirksomhed' | 'Partrederi' | 'Filial' | 'Enkeltmandsvirksomhed' | 'PMV' | 'Forening': Gets or sets the key merchant company type.
  - `description` string, nullable: Gets or sets the description for the company.
  - `companyWebsite` string, nullable: Gets or sets the merchant's company website URL.
  - `industries` Industry[], nullable: Gets or sets the list of industries in which the company conducts business.
    - `code` string, required: Gets or sets the SIC code for the industry.
    - `description` string, required: Gets or sets the description of the industry.
  - `confirmedCreditSearch` boolean: Gets or sets a value indicating whether the lead has given their consent for a credit search. This parameter has to be true in order for the lead to be able to submit the application (stage 1).
  - `employerIdentificationNumber` string, nullable: Gets or sets the merchants tax identification number (required for USA).

## Response `204`

No Content

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/youlend/apis/onboarding.md) - [All operations](https://skmtc.dev/youlend/apis/onboarding/llms.txt) - [OpenAPI document](https://skmtc.dev/youlend/apis/onboarding/revisions/32aa9c8d752a?raw)