--- updatedAt: 2026-09-09T09:29:24.000Z agentTools: projectIndex: https://docs.youlend.com/llms.txt --- # Update significant persons. ### Be aware (EUR) In Europe, at least one `Director` or `DirectorAndBeneficialOwner` must be on a lead in order to submit A `Director` runs a business but has no ownership interest A `BeneficialOwner` owns a business but has no involvement in running the business A `DirectorAndBeneficialOwner`owns and runs a business - this is the most common type for small and medium enterprises. ### Be aware (USA) In the USA, at least one `ExecutiveOfficer` or `ExecutiveOfficerAndOwner` must be on a lead in order to submit An `ExecutiveOfficer` runs a business but has no ownership interest A `BeneficialOwner` owns a business but has no involvement in running the business A `ExecutiveOfficerAndOwner`owns and runs a business - this is the most common type for small and medium enterprises. ### Important to know You cannot use this endpoint to change a signatory linked to a holding company. Do not remove the holding company from the request as a workaround. Contact YouLend if you need to change this information.
Parameter Best practice Good Example
`address` Provide the house/flat number and name of the road in line1 `"line1": "5 Happy Road"`
`contactPhoneNumber` Include the telephone country code "contactPhoneNumber": "+44000000000"
`percentageOwned` Ensure the total ownership across all significantPersons does not exceed 100 Person A: "percentageOwned": 60 Person B: "percentageOwned": 40"
`placeOfBirth` The format for this param is: \{city\}, \{country\}\` where country follows the ISO 3166 3 letter code in Country ISO Codes. London, GBR
# OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Onboarding", "description": "Through this API you can can initiate the process of onboarding a borrower with YouLend", "contact": { "name": "Mark Ufland", "email": "mark.ufland@youlend.com" }, "version": "1.0" }, "servers": [ { "url": "https://partners.staging-youlendapi.com/onboarding" } ], "paths": { "/Leads/{leadId}/significantpersons": { "put": { "tags": [ "Create an Application" ], "summary": "Update significant persons.", "parameters": [ { "name": "leadId", "in": "path", "description": "The lead id.", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "api-version", "in": "header", "schema": { "type": "string" } } ], "requestBody": { "description": "A significant person model.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SignificantPersonsModel" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SaveSignificantPersonsResultModel" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/SaveSignificantPersonsResultModel" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } } }, "components": { "schemas": { "AddressModel": { "required": [ "areaCode", "city", "line1" ], "type": "object", "properties": { "line1": { "maxLength": 255, "minLength": 1, "type": "string", "description": "Gets or sets Address Line 1." }, "line2": { "type": "string", "description": "Gets or sets Address Line 2.", "nullable": true }, "line3": { "type": "string", "description": "Gets or sets Address Line 3.", "nullable": true }, "city": { "maxLength": 255, "minLength": 1, "type": "string", "description": "Gets or sets the City." }, "region": { "type": "string", "description": "Gets or sets the Region.", "nullable": true }, "areaCode": { "maxLength": 255, "minLength": 1, "type": "string", "description": "Gets or sets the Area Code." }, "country": { "type": "string", "description": "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.", "nullable": true }, "countryISOCode": { "enum": [ "GBR", "IRL", "NLD", "BEL", "POL", "USA", "DEU", "FRA", "ESP", "DNK" ], "type": "string", "description": "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." } }, "additionalProperties": false, "description": "Address Data Model." }, "DateModel": { "required": [ "month", "year" ], "type": "object", "properties": { "year": { "maximum": 2008, "minimum": 1900, "type": "integer", "description": "Gets or sets Year.", "format": "int32" }, "month": { "maximum": 12, "minimum": 1, "type": "integer", "description": "Gets or sets Month.", "format": "int32" }, "day": { "type": "integer", "description": "Gets or sets Day.", "format": "int32" } }, "additionalProperties": false, "description": "Date Model." }, "ProblemDetails": { "type": "object", "properties": { "type": { "type": "string", "nullable": true }, "title": { "type": "string", "nullable": true }, "status": { "type": "integer", "format": "int32", "nullable": true }, "detail": { "type": "string", "nullable": true }, "instance": { "type": "string", "nullable": true } }, "additionalProperties": {} }, "SaveSignificantPersonsResultModel": { "type": "object", "properties": { "leadId": { "type": "string", "description": "Gets or sets the Lead Id.", "format": "uuid" }, "significantPersonIds": { "type": "array", "items": { "type": "string", "format": "uuid" }, "description": "Gets or sets the Significant person ids.", "nullable": true } }, "additionalProperties": false, "description": "The result of creating a third party lead." }, "SignificantPersonModel": { "required": [ "address", "dateOfBirth", "emailAddress", "firstName", "mobilePhoneNumber", "surname", "typeOfPerson" ], "type": "object", "properties": { "firstName": { "maxLength": 255, "minLength": 1, "type": "string", "description": "Gets or sets significant person's first name." }, "surname": { "maxLength": 255, "minLength": 1, "type": "string", "description": "Gets or sets significant person's surname." }, "typeOfPerson": { "minLength": 1, "enum": [ "Director", "BeneficialOwner", "DirectorAndBeneficialOwner", "ExecutiveOfficer", "ExecutiveOfficerAndOwner", "Owner" ], "type": "string", "description": "Gets or sets the type of significant person (Director and Beneficial Owner for UK & Europe, Executive Officer and Owner for the USA)." }, "address": { "$ref": "#/components/schemas/AddressModel" }, "dateOfBirth": { "$ref": "#/components/schemas/DateModel" }, "emailAddress": { "minLength": 1, "type": "string", "description": "Gets or sets significant person's email address.", "format": "email" }, "mobilePhoneNumber": { "minLength": 1, "type": "string", "description": "Gets or sets significant person's mobile phone number (international format, example +447586312453)." }, "percentageOwned": { "maximum": 100, "minimum": 0, "type": "number", "description": "Gets or sets the percentage of ownership the significant person has.", "format": "double" }, "nationality": { "type": "string", "description": "Gets or sets significant person's nationality.", "nullable": true }, "niNumber": { "type": "string", "description": "Gets or sets significant person's NI number.", "nullable": true }, "socialSecurityNumber": { "type": "string", "description": "Gets or sets the social security number (required for owners in the USA).", "nullable": true }, "placeOfBirth": { "type": "string", "description": "Gets or sets significant person's place of birth.", "nullable": true } }, "additionalProperties": false, "description": "Significant Person Data Model.\r\nWe use a custom model binder for this class , please check if you need to modify this." }, "SignificantPersonsModel": { "type": "object", "properties": { "significantPersons": { "type": "array", "items": { "$ref": "#/components/schemas/SignificantPersonModel" }, "description": "Gets or sets a list of significant persons.", "nullable": true } }, "additionalProperties": false, "description": "Collection of significant persons." } }, "securitySchemes": { "oauth2": { "type": "oauth2", "flows": { "clientCredentials": { "tokenUrl": "https://youlend-stag.eu.auth0.com/oauth/token", "scopes": {} } } } } }, "security": [ { "oauth2": [] } ], "tags": [ { "name": "Create an Application" } ] } ```