{"title":"Manage legal entities","category":"default","creationDate":1704386220,"content":"<p>A legal entity is an API resource that describes an individual or an organization on your Balance Platform. It contains information about your user, for example, the legal name, address, and tax information of the individual or organization. Adyen uses this information to perform <a href=\"\/pt\/business-accounts\/verification-overview\">verification checks<\/a> as required by payment industry regulations.<\/p>\n<p>The legal entity resource also contains the associations that the legal entity has with other entities on your platform. For example, most organizations need a signatory.<\/p>\n<p>To manage legal entities, use the <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/3\/overview\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Legal Entity Management API<\/a>.<\/p>\n<p>This page contains instructions for common legal entity operations. These operations are part of a larger process which includes <a href=\"\/pt\/business-accounts\/verification-overview\">verification<\/a> and <a href=\"\/pt\/business-accounts\/onboard-users\">onboarding steps<\/a>.<\/p>\n<h2>Create a legal entity<\/h2>\n<p>Creating a legal entity is the first step in moving users though the onboarding and verification process. Adyen uses the details you include when you create the legal entity to <a href=\"\/pt\/business-accounts\/verification-overview\">verify the account holder<\/a> that is linked to the legal entity.<\/p>\n<p>The minimum required information for creating a legal entity depends on the location and entity type that you are onboarding. <\/p>\n<p>To create a legal entity:<\/p>\n<ol>\n<li>\n<p>Make a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/legalEntities<\/a> request using the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#request-individual\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">individual<\/a> or  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities#request-organization\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">organization<\/a> details. The following example shows how to create an organization in the United States.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Create legal entity request'\" :id=\"'create-a-legal-entity'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;curl&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/kyc-test.adyen.com\\\/lem\\\/v3\\\/legalEntities \\\\\\n-H 'x-api-key: ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-X POST \\\\\\n-d '{\\n  \\&quot;type\\&quot;: \\&quot;organization\\&quot;,\\n  \\&quot;organization\\&quot;: {\\n    \\&quot;legalName\\&quot;: \\&quot;Explorer Company based in US\\&quot;,\\n    \\&quot;registrationNumber\\&quot;: \\&quot;101002749\\&quot;,\\n    \\&quot;type\\&quot;: \\&quot;privateCompany\\&quot;,\\n    \\&quot;registeredAddress\\&quot;: {\\n      \\&quot;city\\&quot;: \\&quot;New York\\&quot;,\\n      \\&quot;country\\&quot;: \\&quot;US\\&quot;,\\n      \\&quot;postalCode\\&quot;: \\&quot;10003\\&quot;,\\n      \\&quot;stateOrProvince\\&quot;: \\&quot;NY\\&quot;,\\n      \\&quot;street\\&quot;: \\&quot;71 5th Avenue\\&quot;,\\n      \\&quot;street2\\&quot;: \\&quot;11th floor\\&quot;\\n    }\\n  }\\n}'&quot;},{&quot;language&quot;:&quot;java&quot;,&quot;tabTitle&quot;:&quot;Java&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Java API Library v33.0.0\\nimport com.adyen.Client;\\nimport com.adyen.enums.Environment;\\nimport com.adyen.model.legalentitymanagement.*;\\nimport java.time.OffsetDateTime;\\nimport java.util.*;\\nimport com.adyen.service.legalEntityManagement.*;\\n\\nClient client = new Client(\\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;, Environment.TEST);\\n\\n\\\/\\\/ Create the request object(s)\\nAddress address = new Address()\\n  .country(\\&quot;US\\&quot;)\\n  .stateOrProvince(\\&quot;NY\\&quot;)\\n  .city(\\&quot;New York\\&quot;)\\n  .street(\\&quot;71 5th Avenue\\&quot;)\\n  .postalCode(\\&quot;10003\\&quot;)\\n  .street2(\\&quot;11th floor\\&quot;);\\n\\nOrganization organization = new Organization()\\n  .legalName(\\&quot;Explorer Company based in US\\&quot;)\\n  .registeredAddress(address)\\n  .registrationNumber(\\&quot;101002749\\&quot;)\\n  .type(Organization.TypeEnum.PRIVATECOMPANY);\\n\\nLegalEntityInfoRequiredType legalEntityInfoRequiredType = new LegalEntityInfoRequiredType()\\n  .organization(organization)\\n  .type(LegalEntityInfoRequiredType.TypeEnum.ORGANIZATION);\\n\\n\\\/\\\/ Send the request\\nLegalEntitiesApi service = new LegalEntitiesApi(client);\\nLegalEntity response = service.createLegalEntity(legalEntityInfoRequiredType, null);&quot;},{&quot;language&quot;:&quot;php&quot;,&quot;tabTitle&quot;:&quot;PHP&quot;,&quot;content&quot;:&quot;&lt;?php\\n\\\/\\\/ Adyen PHP API Library v24.0.0\\nuse Adyen\\\\Client;\\nuse Adyen\\\\Environment;\\nuse Adyen\\\\Model\\\\LegalEntityManagement\\\\Address;\\nuse Adyen\\\\Model\\\\LegalEntityManagement\\\\Organization;\\nuse Adyen\\\\Model\\\\LegalEntityManagement\\\\LegalEntityInfoRequiredType;\\nuse Adyen\\\\Service\\\\LegalEntityManagement\\\\LegalEntitiesApi;\\n\\n$client = new Client();\\n$client-&gt;setXApiKey(\\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;);\\n$client-&gt;setEnvironment(Environment::TEST);\\n\\n\\n\\\/\\\/ Create the request object(s)\\n$address = new Address();\\n$address\\n  -&gt;setCountry(\\&quot;US\\&quot;)\\n  -&gt;setStateOrProvince(\\&quot;NY\\&quot;)\\n  -&gt;setCity(\\&quot;New York\\&quot;)\\n  -&gt;setStreet(\\&quot;71 5th Avenue\\&quot;)\\n  -&gt;setPostalCode(\\&quot;10003\\&quot;)\\n  -&gt;setStreet2(\\&quot;11th floor\\&quot;);\\n\\n$organization = new Organization();\\n$organization\\n  -&gt;setLegalName(\\&quot;Explorer Company based in US\\&quot;)\\n  -&gt;setRegisteredAddress($address)\\n  -&gt;setRegistrationNumber(\\&quot;101002749\\&quot;)\\n  -&gt;setType(\\&quot;privateCompany\\&quot;);\\n\\n$legalEntityInfoRequiredType = new LegalEntityInfoRequiredType();\\n$legalEntityInfoRequiredType\\n  -&gt;setOrganization($organization)\\n  -&gt;setType(\\&quot;organization\\&quot;);\\n\\n\\\/\\\/ Send the request\\n$service = new LegalEntitiesApi($client);\\n$response = $service-&gt;createLegalEntity($legalEntityInfoRequiredType);&quot;},{&quot;language&quot;:&quot;cs&quot;,&quot;tabTitle&quot;:&quot;C#&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen .net API Library v28.0.0\\nusing Adyen;\\nusing Environment = Adyen.Model.Environment;\\nusing Adyen.Model;\\nusing Adyen.Model.LegalEntityManagement;\\nusing Adyen.Service.LegalEntityManagement;\\n\\nvar config = new Config()\\n{\\n    XApiKey = \\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;,\\n    Environment = Environment.Test\\n};\\nvar client = new Client(config);\\n\\n\\\/\\\/ Create the request object(s)\\nAddress address = new Address\\n{\\n  Country = \\&quot;US\\&quot;,\\n  StateOrProvince = \\&quot;NY\\&quot;,\\n  City = \\&quot;New York\\&quot;,\\n  Street = \\&quot;71 5th Avenue\\&quot;,\\n  PostalCode = \\&quot;10003\\&quot;,\\n  Street2 = \\&quot;11th floor\\&quot;\\n};\\n\\nOrganization organization = new Organization\\n{\\n  LegalName = \\&quot;Explorer Company based in US\\&quot;,\\n  RegisteredAddress = address,\\n  RegistrationNumber = \\&quot;101002749\\&quot;,\\n  Type = Organization.TypeEnum.PrivateCompany\\n};\\n\\nLegalEntityInfoRequiredType legalEntityInfoRequiredType = new LegalEntityInfoRequiredType\\n{\\n  Organization = organization,\\n  Type = LegalEntityInfoRequiredType.TypeEnum.Organization\\n};\\n\\n\\\/\\\/ Send the request\\nvar service = new LegalEntitiesService(client);\\nvar response = service.CreateLegalEntity(legalEntityInfoRequiredType);&quot;},{&quot;language&quot;:&quot;js&quot;,&quot;tabTitle&quot;:&quot;NodeJS (JavaScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v23.3.0\\nconst { Client, LegalEntityManagementAPI } = require('@adyen\\\/api-library');\\n\\nconst client = new Client({ apiKey: \\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot; });\\n\\n\\\/\\\/ Create the request object(s)\\nconst legalEntityInfoRequiredType = {\\n  type: \\&quot;organization\\&quot;,\\n  organization: {\\n    legalName: \\&quot;Explorer Company based in US\\&quot;,\\n    registrationNumber: \\&quot;101002749\\&quot;,\\n    type: \\&quot;privateCompany\\&quot;,\\n    registeredAddress: {\\n      city: \\&quot;New York\\&quot;,\\n      country: \\&quot;US\\&quot;,\\n      postalCode: \\&quot;10003\\&quot;,\\n      stateOrProvince: \\&quot;NY\\&quot;,\\n      street: \\&quot;71 5th Avenue\\&quot;,\\n      street2: \\&quot;11th floor\\&quot;\\n    }\\n  }\\n}\\n\\n\\\/\\\/ Send the request\\nconst legalEntityManagementAPI = new LegalEntityManagementAPI(client);\\nconst response = legalEntityManagementAPI.LegalEntitiesApi.createLegalEntity(legalEntityInfoRequiredType);&quot;},{&quot;language&quot;:&quot;go&quot;,&quot;tabTitle&quot;:&quot;Go&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Go API Library v17.0.0\\nimport (\\n  \\&quot;context\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v17\\\/src\\\/common\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v17\\\/src\\\/adyen\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v17\\\/src\\\/legalEntityManagement\\&quot;\\n)\\nclient := adyen.NewClient(&amp;common.Config{\\n  ApiKey:      \\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;,\\n  Environment: common.TestEnv,\\n})\\n\\n\\\/\\\/ Create the request object(s)\\naddress := legalEntityManagement.Address{\\n  Country: \\&quot;US\\&quot;,\\n  StateOrProvince: common.PtrString(\\&quot;NY\\&quot;),\\n  City: common.PtrString(\\&quot;New York\\&quot;),\\n  Street: common.PtrString(\\&quot;71 5th Avenue\\&quot;),\\n  PostalCode: common.PtrString(\\&quot;10003\\&quot;),\\n  Street2: common.PtrString(\\&quot;11th floor\\&quot;),\\n}\\n\\norganization := legalEntityManagement.Organization{\\n  LegalName: \\&quot;Explorer Company based in US\\&quot;,\\n  RegisteredAddress: address,\\n  RegistrationNumber: common.PtrString(\\&quot;101002749\\&quot;),\\n  Type: common.PtrString(\\&quot;privateCompany\\&quot;),\\n}\\n\\nlegalEntityInfoRequiredType := legalEntityManagement.LegalEntityInfoRequiredType{\\n  Organization: &amp;organization,\\n  Type: \\&quot;organization\\&quot;,\\n}\\n\\n\\\/\\\/ Send the request\\nservice := client.LegalEntityManagement()\\nreq := service.LegalEntitiesApi.CreateLegalEntityInput().LegalEntityInfoRequiredType(legalEntityInfoRequiredType)\\nres, httpRes, err := service.LegalEntitiesApi.CreateLegalEntity(context.Background(), req)&quot;},{&quot;language&quot;:&quot;py&quot;,&quot;tabTitle&quot;:&quot;Python&quot;,&quot;content&quot;:&quot;# Adyen Python API Library v13.3.0\\nimport Adyen\\n\\nadyen = Adyen.Adyen()\\nadyen.client.xapikey = \\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;\\nadyen.client.platform = \\&quot;test\\&quot; # The environment to use library in.\\n\\n# Create the request object(s)\\njson_request = {\\n  \\&quot;type\\&quot;: \\&quot;organization\\&quot;,\\n  \\&quot;organization\\&quot;: {\\n    \\&quot;legalName\\&quot;: \\&quot;Explorer Company based in US\\&quot;,\\n    \\&quot;registrationNumber\\&quot;: \\&quot;101002749\\&quot;,\\n    \\&quot;type\\&quot;: \\&quot;privateCompany\\&quot;,\\n    \\&quot;registeredAddress\\&quot;: {\\n      \\&quot;city\\&quot;: \\&quot;New York\\&quot;,\\n      \\&quot;country\\&quot;: \\&quot;US\\&quot;,\\n      \\&quot;postalCode\\&quot;: \\&quot;10003\\&quot;,\\n      \\&quot;stateOrProvince\\&quot;: \\&quot;NY\\&quot;,\\n      \\&quot;street\\&quot;: \\&quot;71 5th Avenue\\&quot;,\\n      \\&quot;street2\\&quot;: \\&quot;11th floor\\&quot;\\n    }\\n  }\\n}\\n\\n# Send the request\\nresult = adyen.legalEntityManagement.legal_entities_api.create_legal_entity(request=json_request)&quot;},{&quot;language&quot;:&quot;rb&quot;,&quot;tabTitle&quot;:&quot;Ruby&quot;,&quot;content&quot;:&quot;# Adyen Ruby API Library v10.1.1\\nrequire \\&quot;adyen-ruby-api-library\\&quot;\\n\\nadyen = Adyen::Client.new\\nadyen.api_key = 'ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY'\\nadyen.env = :test # Set to \\&quot;live\\&quot; for live environment\\n\\n# Create the request object(s)\\nrequest_body = {\\n  :type =&gt; 'organization',\\n  :organization =&gt; {\\n    :legalName =&gt; 'Explorer Company based in US',\\n    :registrationNumber =&gt; '101002749',\\n    :type =&gt; 'privateCompany',\\n    :registeredAddress =&gt; {\\n      :city =&gt; 'New York',\\n      :country =&gt; 'US',\\n      :postalCode =&gt; '10003',\\n      :stateOrProvince =&gt; 'NY',\\n      :street =&gt; '71 5th Avenue',\\n      :street2 =&gt; '11th floor'\\n    }\\n  }\\n}\\n\\n# Send the request\\nresult = adyen.legalEntityManagement.legal_entities_api.create_legal_entity(request_body)&quot;},{&quot;language&quot;:&quot;ts&quot;,&quot;tabTitle&quot;:&quot;NodeJS (TypeScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v23.3.0\\nimport { Client, LegalEntityManagementAPI, Types } from \\&quot;@adyen\\\/api-library\\&quot;;\\n\\nconst client = new Client({ apiKey: \\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot; });\\n\\n\\\/\\\/ Create the request object(s)\\nconst address: Types.legalEntityManagement.Address = {\\n  country: \\&quot;US\\&quot;,\\n  stateOrProvince: \\&quot;NY\\&quot;,\\n  city: \\&quot;New York\\&quot;,\\n  street: \\&quot;71 5th Avenue\\&quot;,\\n  postalCode: \\&quot;10003\\&quot;,\\n  street2: \\&quot;11th floor\\&quot;\\n};\\n\\nconst organization: Types.legalEntityManagement.Organization = {\\n  legalName: \\&quot;Explorer Company based in US\\&quot;,\\n  registeredAddress: address,\\n  registrationNumber: \\&quot;101002749\\&quot;,\\n  type: Types.legalEntityManagement.Organization.TypeEnum.PrivateCompany\\n};\\n\\nconst legalEntityInfoRequiredType: Types.legalEntityManagement.LegalEntityInfoRequiredType = {\\n  organization: organization,\\n  type: Types.legalEntityManagement.LegalEntityInfoRequiredType.TypeEnum.Organization\\n};\\n\\n\\\/\\\/ Send the request\\nconst legalEntityManagementAPI = new LegalEntityManagementAPI(client);\\nconst response = legalEntityManagementAPI.LegalEntitiesApi.createLegalEntity(legalEntityInfoRequiredType);&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>The response contains a generated legal entity <code>id<\/code>. Save this response because you need the ID to:<\/p>\n<ul>\n<li><a href=\"\/pt\/business-accounts\/manage-account-holders#create-an-account-holder\">Create an account holder<\/a><\/li>\n<li><a href=\"#view-legal-entity-details\">View a legal entity<\/a><\/li>\n<li><a href=\"#update-a-legal-entity\">Update a legal entity<\/a>\n<\/li>\n<\/ul>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Create legal entity response'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"organization\\\": {\\n        \\\"legalName\\\": \\\"Explorer Company based in US\\\",\\n        \\\"registeredAddress\\\": {\\n            \\\"city\\\": \\\"New York\\\",\\n            \\\"country\\\": \\\"US\\\",\\n            \\\"postalCode\\\": \\\"10003\\\",\\n            \\\"stateOrProvince\\\": \\\"NY\\\",\\n            \\\"street\\\": \\\"71 5th Avenue\\\",\\n            \\\"street2\\\": \\\"11th floor\\\"\\n        },\\n        \\\"registrationNumber\\\": \\\"101002749\\\",\\n        \\\"type\\\": \\\"privateCompany\\\"\\n    },\\n    \\\"type\\\": \\\"organization\\\",\\n    \\\/\\\/ Generated legal entity ID\\n    \\\"id\\\": \\\"LE00000000000000000000001\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<\/ol>\n<h2>View legal entity details<\/h2>\n<p>After creating a legal entity, you can view the resource at any time using the <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>, the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/overview\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Legal Entity Management API<\/a>, or hosted onboarding.<\/p>\n\n<div id=\"tabWLOt4\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Customer Area&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To view the legal entity details of an account holder in your &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Customer Area&lt;\\\/a&gt;, you can &lt;a href=\\&quot;\\\/pt\\\/business-accounts\\\/manage-account-holders?tab=ah-customer-area_2#get-account-holders\\&quot;&gt;search for the account holder&lt;\\\/a&gt; associated to the legal entity. As an alternative:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n  &lt;li&gt;\\n&lt;p&gt;Select &lt;b&gt;Accounts &amp;amp; balances&lt;\\\/b&gt; &amp;gt; &lt;b&gt;Account holders&lt;\\\/b&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n  &lt;li&gt;\\n&lt;p&gt;In the account holder table, select an &lt;b&gt;Account holder ID&lt;\\\/b&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n  &lt;li&gt;\\n&lt;p&gt;In the &lt;b&gt;Account holder details&lt;\\\/b&gt; page, select &lt;b&gt;Overview&lt;\\\/b&gt; &amp;gt; &lt;b&gt;Legal entity&lt;\\\/b&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;p&gt;The legal entity details of the main legal entity are shown. You can view bank account information for the main legal entity under &lt;strong&gt;Transfer instruments&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;p&gt;If the legal entity is an organization, the page also shows details about the associated legal entities under &lt;strong&gt;Entity associations&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;p&gt;If the legal entity is an individual or a sole proprietorship, their personally identifiable information (PII) is redacted. Personally identifiable information includes their:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Name&lt;\\\/li&gt;\\n&lt;li&gt;Address (except for the country\\\/region)&lt;\\\/li&gt;\\n&lt;li&gt;Date of birth&lt;\\\/li&gt;\\n&lt;li&gt;Email address&lt;\\\/li&gt;\\n&lt;li&gt;Phone number&lt;\\\/li&gt;\\n&lt;li&gt;IBAN or bank account number&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;To view this information in its unredacted state, you must have the &lt;strong&gt;View account holders PII data&lt;\\\/strong&gt; &lt;a href=\\&quot;\\\/pt\\\/account\\\/user-roles#platforms\\&quot;&gt;user role&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&quot;,&quot;altTitle&quot;:&quot;CA&quot;,&quot;oldTabId&quot;:&quot;view-CA_1&quot;,&quot;relation&quot;:&quot;CA&quot;},{&quot;title&quot;:&quot;API&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To view legal entity details with the API:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;Make a GET  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/legalentity\\\/latest\\\/patch\\\/legalEntities\\\/(id)\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/legalEntities\\\/{id}&lt;\\\/a&gt; request using the main &lt;a href=\\&quot;#create-legal-entity\\&quot;&gt;legal entity ID&lt;\\\/a&gt; as a path parameter.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;View legal entity details&#039;\\&quot; :id=\\&quot;&#039;get-le&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;curl&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\\\/\\\\\\\/kyc-test.adyen.com\\\\\\\/lem\\\\\\\/v3\\\\\\\/legalEntities\\\\\\\/LE00000000000000000000001 \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-X GET \\\\\\\\&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;java&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Java&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Java API Library v33.0.0\\\\nimport com.adyen.Client;\\\\nimport com.adyen.enums.Environment;\\\\nimport com.adyen.model.legalentitymanagement.*;\\\\nimport java.time.OffsetDateTime;\\\\nimport java.util.*;\\\\nimport com.adyen.service.legalEntityManagement.*;\\\\n\\\\nClient client = new Client(\\\\&amp;quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\\\&amp;quot;, Environment.TEST);\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\nLegalEntitiesApi service = new LegalEntitiesApi(client);\\\\nLegalEntity response = service.getLegalEntity(\\\\&amp;quot;id\\\\&amp;quot;, null);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;php&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;PHP&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;&amp;lt;?php\\\\n\\\\\\\/\\\\\\\/ Adyen PHP API Library v24.0.0\\\\nuse Adyen\\\\\\\\Client;\\\\nuse Adyen\\\\\\\\Environment;\\\\nuse Adyen\\\\\\\\Service\\\\\\\\LegalEntityManagement\\\\\\\\LegalEntitiesApi;\\\\n\\\\n$client = new Client();\\\\n$client-&amp;gt;setXApiKey(\\\\&amp;quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\\\&amp;quot;);\\\\n$client-&amp;gt;setEnvironment(Environment::TEST);\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\n$service = new LegalEntitiesApi($client);\\\\n$response = $service-&amp;gt;getLegalEntity(&#039;id&#039;);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;cs&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;C#&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen .net API Library v28.0.0\\\\nusing Adyen;\\\\nusing Environment = Adyen.Model.Environment;\\\\nusing Adyen.Model;\\\\nusing Adyen.Model.LegalEntityManagement;\\\\nusing Adyen.Service.LegalEntityManagement;\\\\n\\\\nvar config = new Config()\\\\n{\\\\n    XApiKey = \\\\&amp;quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\\\&amp;quot;,\\\\n    Environment = Environment.Test\\\\n};\\\\nvar client = new Client(config);\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\nvar service = new LegalEntitiesService(client);\\\\nvar response = service.GetLegalEntity(\\\\&amp;quot;id\\\\&amp;quot;);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;js&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;NodeJS (JavaScript)&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Node API Library v23.3.0\\\\nconst { Client, LegalEntityManagementAPI } = require(&#039;@adyen\\\\\\\/api-library&#039;);\\\\n\\\\nconst client = new Client({ apiKey: \\\\&amp;quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\\\&amp;quot;, environment: \\\\&amp;quot;TEST\\\\&amp;quot; });\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\nconst legalEntityManagementAPI = new LegalEntityManagementAPI(client);\\\\nconst response = legalEntityManagementAPI.LegalEntitiesApi.getLegalEntity(\\\\&amp;quot;id\\\\&amp;quot;);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;go&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Go&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Go API Library v17.0.0\\\\nimport (\\\\n  \\\\&amp;quot;context\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v17\\\\\\\/src\\\\\\\/common\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v17\\\\\\\/src\\\\\\\/adyen\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v17\\\\\\\/src\\\\\\\/legalEntityManagement\\\\&amp;quot;\\\\n)\\\\nclient := adyen.NewClient(&amp;amp;common.Config{\\\\n  ApiKey:      \\\\&amp;quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\\\&amp;quot;,\\\\n  Environment: common.TestEnv,\\\\n})\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\nservice := client.LegalEntityManagement()\\\\nreq := service.LegalEntitiesApi.GetLegalEntityInput(\\\\&amp;quot;id\\\\&amp;quot;)\\\\nres, httpRes, err := service.LegalEntitiesApi.GetLegalEntity(context.Background(), req)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;py&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Python&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;# Adyen Python API Library v13.3.0\\\\nimport Adyen\\\\n\\\\nadyen = Adyen.Adyen()\\\\nadyen.client.xapikey = \\\\&amp;quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\\\&amp;quot;\\\\nadyen.client.platform = \\\\&amp;quot;test\\\\&amp;quot; # The environment to use library in.\\\\n\\\\n# Send the request\\\\nresult = adyen.legalEntityManagement.legal_entities_api.get_legal_entity(id=\\\\&amp;quot;id\\\\&amp;quot;)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;rb&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Ruby&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;# Adyen Ruby API Library v10.1.1\\\\nrequire \\\\&amp;quot;adyen-ruby-api-library\\\\&amp;quot;\\\\n\\\\nadyen = Adyen::Client.new\\\\nadyen.api_key = &#039;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY&#039;\\\\nadyen.env = :test # Set to \\\\&amp;quot;live\\\\&amp;quot; for live environment\\\\n\\\\n# Send the request\\\\nresult = adyen.legalEntityManagement.legal_entities_api.get_legal_entity(&#039;id&#039;)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;ts&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;NodeJS (TypeScript)&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Node API Library v23.3.0\\\\nimport { Client, LegalEntityManagementAPI, Types } from \\\\&amp;quot;@adyen\\\\\\\/api-library\\\\&amp;quot;;\\\\n\\\\nconst client = new Client({ apiKey: \\\\&amp;quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\\\&amp;quot;, environment: \\\\&amp;quot;TEST\\\\&amp;quot; });\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\nconst legalEntityManagementAPI = new LegalEntityManagementAPI(client);\\\\nconst response = legalEntityManagementAPI.LegalEntitiesApi.getLegalEntity(\\\\&amp;quot;id\\\\&amp;quot;);&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Adyen returns the &lt;strong&gt;legal entity details&lt;\\\/strong&gt; of the requested legal entity ID in the &lt;code&gt;individual&lt;\\\/code&gt; or &lt;code&gt;organization&lt;\\\/code&gt; object.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;View legal entity response&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n   \\\\\\&quot;entityAssociations\\\\\\&quot;: [\\\\n      {\\\\n          \\\\\\&quot;associatorId\\\\\\&quot;: \\\\\\&quot;LE00000000000000000000001\\\\\\&quot;,\\\\n          \\\\\\&quot;entityType\\\\\\&quot;: \\\\\\&quot;soleProprietorship\\\\\\&quot;,\\\\n          \\\\\\&quot;legalEntityId\\\\\\&quot;: \\\\\\&quot;LE00000000000000000000002\\\\\\&quot;,\\\\n          \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;soleProprietorship\\\\\\&quot;\\\\n      }\\\\n   ],\\\\n   \\\\\\&quot;individual\\\\\\&quot;: {\\\\n      \\\\\\&quot;email\\\\\\&quot;: \\\\\\&quot;s.eller@example.com\\\\\\&quot;,\\\\n      \\\\\\&quot;birthData\\\\\\&quot;: {\\\\n          \\\\\\&quot;dateOfBirth\\\\\\&quot;: \\\\\\&quot;1990-06-21\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;name\\\\\\&quot;: {\\\\n          \\\\\\&quot;firstName\\\\\\&quot;: \\\\\\&quot;Shelly\\\\\\&quot;,\\\\n          \\\\\\&quot;lastName\\\\\\&quot;: \\\\\\&quot;Eller\\\\\\&quot;\\\\n      },\\\\n      \\\\\\&quot;residentialAddress\\\\\\&quot;: {\\\\n          \\\\\\&quot;city\\\\\\&quot;: \\\\\\&quot;Amsterdam\\\\\\&quot;,\\\\n          \\\\\\&quot;country\\\\\\&quot;: \\\\\\&quot;NL\\\\\\&quot;,\\\\n          \\\\\\&quot;postalCode\\\\\\&quot;: \\\\\\&quot;1011DJ\\\\\\&quot;,\\\\n          \\\\\\&quot;street\\\\\\&quot;: \\\\\\&quot;Simon Carmiggeltstraat 6 - 50\\\\\\&quot;\\\\n      }\\\\n   },\\\\n  \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;individual\\\\\\&quot;,\\\\n  \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;LE00000000000000000000001\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;To view the details of the &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/legalentity\\\/3\\\/post\\\/legalEntities#request-entityAssociations\\&quot; class=\\&quot;codeLabel external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;associated entities&lt;\\\/a&gt;, make another GET  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/legalentity\\\/latest\\\/patch\\\/legalEntities\\\/(id)\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/legalEntities\\\/{id}&lt;\\\/a&gt; using the &lt;code&gt;legalEntityId&lt;\\\/code&gt; returned in each element of the &lt;code&gt;entityAssociations&lt;\\\/code&gt; array.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:&quot;API&quot;,&quot;oldTabId&quot;:&quot;view-API_2&quot;,&quot;relation&quot;:&quot;API&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2>Update a legal entity<\/h2>\n<p>When the details of your account holders change, you need to update the legal entity. For example, a business can change address or ownership. You can update a legal entity using the Customer Area or the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/overview\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Legal Entity Management API<\/a>.<\/p>\n\n<div id=\"tabfW5sw\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Customer Area&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;Before you begin, make sure you have the following &lt;a href=\\&quot;\\\/pt\\\/account\\\/user-roles\\\/\\&quot;&gt;role&lt;\\\/a&gt;:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;strong&gt;Manage account holders and legal entities&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;To update the legal entity details of an account holder in your &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Customer Area&lt;\\\/a&gt;:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select the merchant account linked to your balance platform.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n  &lt;li&gt;\\n&lt;p&gt;Select &lt;b&gt;Accounts &amp;amp; balances&lt;\\\/b&gt; &amp;gt; &lt;b&gt;Account holders&lt;\\\/b&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n  &lt;li&gt;\\n&lt;p&gt;In the account holder table, select an &lt;b&gt;Account holder ID&lt;\\\/b&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n  &lt;li&gt;\\n    Under &lt;b&gt;Quick actions&lt;\\\/b&gt;, select &lt;b&gt;Go to Onboarding&lt;\\\/b&gt;.\\n    &lt;br&gt;This opens a new browser tab for Hosted onboarding.\\n  &lt;\\\/li&gt;\\n  &lt;li&gt;\\n&lt;p&gt;Edit the details and select &lt;b&gt;Submit&lt;\\\/b&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;customer_area_0_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;API&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To update a legal entity using the API, make a PATCH  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/legalentity\\\/latest\\\/patch\\\/legalEntities\\\/(id)\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/legalEntities\\\/{id}&lt;\\\/a&gt; request with the new details. Only parameters passed in the request body are updated.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Update legal entity details&#039;\\&quot; :id=\\&quot;&#039;update-le&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;curl&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\\\/\\\\\\\/kyc-test.adyen.com\\\\\\\/lem\\\\\\\/v3\\\\\\\/legalEntities\\\\\\\/LE00000000000000000000001 \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-X PATCH \\\\\\\\\\\\n-d &#039;{\\\\n  \\\\&amp;quot;organization\\\\&amp;quot;: {\\\\n    \\\\&amp;quot;legalName\\\\&amp;quot;: \\\\&amp;quot;New Company Name\\\\&amp;quot;,\\\\n    \\\\&amp;quot;registrationNumber\\\\&amp;quot;: \\\\&amp;quot;101002750\\\\&amp;quot;,\\\\n    \\\\&amp;quot;type\\\\&amp;quot;: \\\\&amp;quot;privateCompany\\\\&amp;quot;,\\\\n    \\\\&amp;quot;registeredAddress\\\\&amp;quot;: {\\\\n      \\\\&amp;quot;city\\\\&amp;quot;: \\\\&amp;quot;New York\\\\&amp;quot;,\\\\n      \\\\&amp;quot;country\\\\&amp;quot;: \\\\&amp;quot;US\\\\&amp;quot;,\\\\n      \\\\&amp;quot;postalCode\\\\&amp;quot;: \\\\&amp;quot;10003\\\\&amp;quot;,\\\\n      \\\\&amp;quot;stateOrProvince\\\\&amp;quot;: \\\\&amp;quot;NY\\\\&amp;quot;,\\\\n      \\\\&amp;quot;street\\\\&amp;quot;: \\\\&amp;quot;73 5th Avenue\\\\&amp;quot;,\\\\n      \\\\&amp;quot;street2\\\\&amp;quot;: \\\\&amp;quot;12th floor\\\\&amp;quot;\\\\n    }\\\\n  }\\\\n}&#039;&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;java&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Java&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Java API Library v33.0.0\\\\nimport com.adyen.Client;\\\\nimport com.adyen.enums.Environment;\\\\nimport com.adyen.model.legalentitymanagement.*;\\\\nimport java.time.OffsetDateTime;\\\\nimport java.util.*;\\\\nimport com.adyen.service.legalEntityManagement.*;\\\\n\\\\nClient client = new Client(\\\\&amp;quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\\\&amp;quot;, Environment.TEST);\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nAddress address = new Address()\\\\n  .country(\\\\&amp;quot;US\\\\&amp;quot;)\\\\n  .stateOrProvince(\\\\&amp;quot;NY\\\\&amp;quot;)\\\\n  .city(\\\\&amp;quot;New York\\\\&amp;quot;)\\\\n  .street(\\\\&amp;quot;73 5th Avenue\\\\&amp;quot;)\\\\n  .postalCode(\\\\&amp;quot;10003\\\\&amp;quot;)\\\\n  .street2(\\\\&amp;quot;12th floor\\\\&amp;quot;);\\\\n\\\\nOrganization organization = new Organization()\\\\n  .legalName(\\\\&amp;quot;New Company Name\\\\&amp;quot;)\\\\n  .registeredAddress(address)\\\\n  .registrationNumber(\\\\&amp;quot;101002750\\\\&amp;quot;)\\\\n  .type(Organization.TypeEnum.PRIVATECOMPANY);\\\\n\\\\nLegalEntityInfo legalEntityInfo = new LegalEntityInfo()\\\\n  .organization(organization);\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\nLegalEntitiesApi service = new LegalEntitiesApi(client);\\\\nLegalEntity response = service.updateLegalEntity(\\\\&amp;quot;id\\\\&amp;quot;, legalEntityInfo, null);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;php&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;PHP&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;&amp;lt;?php\\\\n\\\\\\\/\\\\\\\/ Adyen PHP API Library v24.0.0\\\\nuse Adyen\\\\\\\\Client;\\\\nuse Adyen\\\\\\\\Environment;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\LegalEntityManagement\\\\\\\\Address;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\LegalEntityManagement\\\\\\\\Organization;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\LegalEntityManagement\\\\\\\\LegalEntityInfo;\\\\nuse Adyen\\\\\\\\Service\\\\\\\\LegalEntityManagement\\\\\\\\LegalEntitiesApi;\\\\n\\\\n$client = new Client();\\\\n$client-&amp;gt;setXApiKey(\\\\&amp;quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\\\&amp;quot;);\\\\n$client-&amp;gt;setEnvironment(Environment::TEST);\\\\n\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\n$address = new Address();\\\\n$address\\\\n  -&amp;gt;setCountry(\\\\&amp;quot;US\\\\&amp;quot;)\\\\n  -&amp;gt;setStateOrProvince(\\\\&amp;quot;NY\\\\&amp;quot;)\\\\n  -&amp;gt;setCity(\\\\&amp;quot;New York\\\\&amp;quot;)\\\\n  -&amp;gt;setStreet(\\\\&amp;quot;73 5th Avenue\\\\&amp;quot;)\\\\n  -&amp;gt;setPostalCode(\\\\&amp;quot;10003\\\\&amp;quot;)\\\\n  -&amp;gt;setStreet2(\\\\&amp;quot;12th floor\\\\&amp;quot;);\\\\n\\\\n$organization = new Organization();\\\\n$organization\\\\n  -&amp;gt;setLegalName(\\\\&amp;quot;New Company Name\\\\&amp;quot;)\\\\n  -&amp;gt;setRegisteredAddress($address)\\\\n  -&amp;gt;setRegistrationNumber(\\\\&amp;quot;101002750\\\\&amp;quot;)\\\\n  -&amp;gt;setType(\\\\&amp;quot;privateCompany\\\\&amp;quot;);\\\\n\\\\n$legalEntityInfo = new LegalEntityInfo();\\\\n$legalEntityInfo\\\\n  -&amp;gt;setOrganization($organization);\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\n$service = new LegalEntitiesApi($client);\\\\n$response = $service-&amp;gt;updateLegalEntity(&#039;id&#039;, $legalEntityInfo);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;cs&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;C#&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen .net API Library v28.0.0\\\\nusing Adyen;\\\\nusing Environment = Adyen.Model.Environment;\\\\nusing Adyen.Model;\\\\nusing Adyen.Model.LegalEntityManagement;\\\\nusing Adyen.Service.LegalEntityManagement;\\\\n\\\\nvar config = new Config()\\\\n{\\\\n    XApiKey = \\\\&amp;quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\\\&amp;quot;,\\\\n    Environment = Environment.Test\\\\n};\\\\nvar client = new Client(config);\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nAddress address = new Address\\\\n{\\\\n  Country = \\\\&amp;quot;US\\\\&amp;quot;,\\\\n  StateOrProvince = \\\\&amp;quot;NY\\\\&amp;quot;,\\\\n  City = \\\\&amp;quot;New York\\\\&amp;quot;,\\\\n  Street = \\\\&amp;quot;73 5th Avenue\\\\&amp;quot;,\\\\n  PostalCode = \\\\&amp;quot;10003\\\\&amp;quot;,\\\\n  Street2 = \\\\&amp;quot;12th floor\\\\&amp;quot;\\\\n};\\\\n\\\\nOrganization organization = new Organization\\\\n{\\\\n  LegalName = \\\\&amp;quot;New Company Name\\\\&amp;quot;,\\\\n  RegisteredAddress = address,\\\\n  RegistrationNumber = \\\\&amp;quot;101002750\\\\&amp;quot;,\\\\n  Type = Organization.TypeEnum.PrivateCompany\\\\n};\\\\n\\\\nLegalEntityInfo legalEntityInfo = new LegalEntityInfo\\\\n{\\\\n  Organization = organization\\\\n};\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\nvar service = new LegalEntitiesService(client);\\\\nvar response = service.UpdateLegalEntity(\\\\&amp;quot;id\\\\&amp;quot;, legalEntityInfo);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;js&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;NodeJS (JavaScript)&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Node API Library v23.3.0\\\\nconst { Client, LegalEntityManagementAPI } = require(&#039;@adyen\\\\\\\/api-library&#039;);\\\\n\\\\nconst client = new Client({ apiKey: \\\\&amp;quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\\\&amp;quot;, environment: \\\\&amp;quot;TEST\\\\&amp;quot; });\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nconst legalEntityInfo = {\\\\n  organization: {\\\\n    legalName: \\\\&amp;quot;New Company Name\\\\&amp;quot;,\\\\n    registrationNumber: \\\\&amp;quot;101002750\\\\&amp;quot;,\\\\n    type: \\\\&amp;quot;privateCompany\\\\&amp;quot;,\\\\n    registeredAddress: {\\\\n      city: \\\\&amp;quot;New York\\\\&amp;quot;,\\\\n      country: \\\\&amp;quot;US\\\\&amp;quot;,\\\\n      postalCode: \\\\&amp;quot;10003\\\\&amp;quot;,\\\\n      stateOrProvince: \\\\&amp;quot;NY\\\\&amp;quot;,\\\\n      street: \\\\&amp;quot;73 5th Avenue\\\\&amp;quot;,\\\\n      street2: \\\\&amp;quot;12th floor\\\\&amp;quot;\\\\n    }\\\\n  }\\\\n}\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\nconst legalEntityManagementAPI = new LegalEntityManagementAPI(client);\\\\nconst response = legalEntityManagementAPI.LegalEntitiesApi.updateLegalEntity(\\\\&amp;quot;id\\\\&amp;quot;, legalEntityInfo);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;go&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Go&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Go API Library v17.0.0\\\\nimport (\\\\n  \\\\&amp;quot;context\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v17\\\\\\\/src\\\\\\\/common\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v17\\\\\\\/src\\\\\\\/adyen\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v17\\\\\\\/src\\\\\\\/legalEntityManagement\\\\&amp;quot;\\\\n)\\\\nclient := adyen.NewClient(&amp;amp;common.Config{\\\\n  ApiKey:      \\\\&amp;quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\\\&amp;quot;,\\\\n  Environment: common.TestEnv,\\\\n})\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\naddress := legalEntityManagement.Address{\\\\n  Country: \\\\&amp;quot;US\\\\&amp;quot;,\\\\n  StateOrProvince: common.PtrString(\\\\&amp;quot;NY\\\\&amp;quot;),\\\\n  City: common.PtrString(\\\\&amp;quot;New York\\\\&amp;quot;),\\\\n  Street: common.PtrString(\\\\&amp;quot;73 5th Avenue\\\\&amp;quot;),\\\\n  PostalCode: common.PtrString(\\\\&amp;quot;10003\\\\&amp;quot;),\\\\n  Street2: common.PtrString(\\\\&amp;quot;12th floor\\\\&amp;quot;),\\\\n}\\\\n\\\\norganization := legalEntityManagement.Organization{\\\\n  LegalName: \\\\&amp;quot;New Company Name\\\\&amp;quot;,\\\\n  RegisteredAddress: address,\\\\n  RegistrationNumber: common.PtrString(\\\\&amp;quot;101002750\\\\&amp;quot;),\\\\n  Type: common.PtrString(\\\\&amp;quot;privateCompany\\\\&amp;quot;),\\\\n}\\\\n\\\\nlegalEntityInfo := legalEntityManagement.LegalEntityInfo{\\\\n  Organization: &amp;amp;organization,\\\\n}\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\nservice := client.LegalEntityManagement()\\\\nreq := service.LegalEntitiesApi.UpdateLegalEntityInput(\\\\&amp;quot;id\\\\&amp;quot;).LegalEntityInfo(legalEntityInfo)\\\\nres, httpRes, err := service.LegalEntitiesApi.UpdateLegalEntity(context.Background(), req)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;py&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Python&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;# Adyen Python API Library v13.3.0\\\\nimport Adyen\\\\n\\\\nadyen = Adyen.Adyen()\\\\nadyen.client.xapikey = \\\\&amp;quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\\\&amp;quot;\\\\nadyen.client.platform = \\\\&amp;quot;test\\\\&amp;quot; # The environment to use library in.\\\\n\\\\n# Create the request object(s)\\\\njson_request = {\\\\n  \\\\&amp;quot;organization\\\\&amp;quot;: {\\\\n    \\\\&amp;quot;legalName\\\\&amp;quot;: \\\\&amp;quot;New Company Name\\\\&amp;quot;,\\\\n    \\\\&amp;quot;registrationNumber\\\\&amp;quot;: \\\\&amp;quot;101002750\\\\&amp;quot;,\\\\n    \\\\&amp;quot;type\\\\&amp;quot;: \\\\&amp;quot;privateCompany\\\\&amp;quot;,\\\\n    \\\\&amp;quot;registeredAddress\\\\&amp;quot;: {\\\\n      \\\\&amp;quot;city\\\\&amp;quot;: \\\\&amp;quot;New York\\\\&amp;quot;,\\\\n      \\\\&amp;quot;country\\\\&amp;quot;: \\\\&amp;quot;US\\\\&amp;quot;,\\\\n      \\\\&amp;quot;postalCode\\\\&amp;quot;: \\\\&amp;quot;10003\\\\&amp;quot;,\\\\n      \\\\&amp;quot;stateOrProvince\\\\&amp;quot;: \\\\&amp;quot;NY\\\\&amp;quot;,\\\\n      \\\\&amp;quot;street\\\\&amp;quot;: \\\\&amp;quot;73 5th Avenue\\\\&amp;quot;,\\\\n      \\\\&amp;quot;street2\\\\&amp;quot;: \\\\&amp;quot;12th floor\\\\&amp;quot;\\\\n    }\\\\n  }\\\\n}\\\\n\\\\n# Send the request\\\\nresult = adyen.legalEntityManagement.legal_entities_api.update_legal_entity(request=json_request, id=\\\\&amp;quot;id\\\\&amp;quot;)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;rb&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Ruby&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;# Adyen Ruby API Library v10.1.1\\\\nrequire \\\\&amp;quot;adyen-ruby-api-library\\\\&amp;quot;\\\\n\\\\nadyen = Adyen::Client.new\\\\nadyen.api_key = &#039;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY&#039;\\\\nadyen.env = :test # Set to \\\\&amp;quot;live\\\\&amp;quot; for live environment\\\\n\\\\n# Create the request object(s)\\\\nrequest_body = {\\\\n  :organization =&amp;gt; {\\\\n    :legalName =&amp;gt; &#039;New Company Name&#039;,\\\\n    :registrationNumber =&amp;gt; &#039;101002750&#039;,\\\\n    :type =&amp;gt; &#039;privateCompany&#039;,\\\\n    :registeredAddress =&amp;gt; {\\\\n      :city =&amp;gt; &#039;New York&#039;,\\\\n      :country =&amp;gt; &#039;US&#039;,\\\\n      :postalCode =&amp;gt; &#039;10003&#039;,\\\\n      :stateOrProvince =&amp;gt; &#039;NY&#039;,\\\\n      :street =&amp;gt; &#039;73 5th Avenue&#039;,\\\\n      :street2 =&amp;gt; &#039;12th floor&#039;\\\\n    }\\\\n  }\\\\n}\\\\n\\\\n# Send the request\\\\nresult = adyen.legalEntityManagement.legal_entities_api.update_legal_entity(request_body, &#039;id&#039;)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;ts&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;NodeJS (TypeScript)&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Node API Library v23.3.0\\\\nimport { Client, LegalEntityManagementAPI, Types } from \\\\&amp;quot;@adyen\\\\\\\/api-library\\\\&amp;quot;;\\\\n\\\\nconst client = new Client({ apiKey: \\\\&amp;quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\\\&amp;quot;, environment: \\\\&amp;quot;TEST\\\\&amp;quot; });\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nconst address: Types.legalEntityManagement.Address = {\\\\n  country: \\\\&amp;quot;US\\\\&amp;quot;,\\\\n  stateOrProvince: \\\\&amp;quot;NY\\\\&amp;quot;,\\\\n  city: \\\\&amp;quot;New York\\\\&amp;quot;,\\\\n  street: \\\\&amp;quot;73 5th Avenue\\\\&amp;quot;,\\\\n  postalCode: \\\\&amp;quot;10003\\\\&amp;quot;,\\\\n  street2: \\\\&amp;quot;12th floor\\\\&amp;quot;\\\\n};\\\\n\\\\nconst organization: Types.legalEntityManagement.Organization = {\\\\n  legalName: \\\\&amp;quot;New Company Name\\\\&amp;quot;,\\\\n  registeredAddress: address,\\\\n  registrationNumber: \\\\&amp;quot;101002750\\\\&amp;quot;,\\\\n  type: Types.legalEntityManagement.Organization.TypeEnum.PrivateCompany\\\\n};\\\\n\\\\nconst legalEntityInfo: Types.legalEntityManagement.LegalEntityInfo = {\\\\n  organization: organization\\\\n};\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\nconst legalEntityManagementAPI = new LegalEntityManagementAPI(client);\\\\nconst response = legalEntityManagementAPI.LegalEntitiesApi.updateLegalEntity(\\\\&amp;quot;id\\\\&amp;quot;, legalEntityInfo);&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;api_1_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<p>Verification checks will be run again when legal entity details are updated.<\/p>\n<h3>Change legal entity type<\/h3>\n<p>Users sometimes sign up with an incorrect legal entity type. To change the legal entity type to the correct one, you can make a PATCH  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/patch\/legalEntities\/(id)\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/legalEntities\/{id}<\/a> request to update the legal entity type and then provide additional required information.<\/p>\n<p>All verification checks are run again after the legal entity type is changed.<\/p>\n<p>You can only change the type of the main legal entity. If the type of an associated legal entity is incorrect, you need to create a new legal entity.<\/p>\n<h4>Retained information<\/h4>\n<p>When you change the legal entity type, the following information is retained:<\/p>\n<ul>\n<li>The legal entity id<\/li>\n<li>Transfer instruments<\/li>\n<li>Bank statement details<\/li>\n<li>Proof of industry<\/li>\n<li>Processed amounts<\/li>\n<li>Business lines<\/li>\n<\/ul>\n<p>When changing between an individual and an organization legal entity, the following information is migrated:<\/p>\n<ul>\n<li>The <code>country<\/code> is migrated from the individual <code>residentialAddress<\/code> to the organization <code>registeredAddress<\/code>.<\/li>\n<li>The individual <code>name<\/code> is migrated to the organization <code>legalName<\/code>.<\/li>\n<\/ul>\n<p>When changing between an organization and an individual legal entity, the following information is migrated:<\/p>\n<ul>\n<li>The <code>country<\/code> is migrated from the organization <code>registeredAddress<\/code> to the individual <code>residentialAddress<\/code>.<\/li>\n<li>The organization <code>legalName<\/code> is migrated to the individual <code>name<\/code>.<\/li>\n<\/ul>\n<h4>Make an API request<\/h4>\n<p>You can only directly change a legal entity type from:<\/p>\n<ul>\n<li>individual to organization<\/li>\n<li>organization to individual<\/li>\n<\/ul>\n<p>The example below shows how you can change a legal entity from an individual to an organization. Provide the new <code>type<\/code> in your PATCH  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/patch\/legalEntities\/(id)\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/legalEntities\/{id}<\/a> request:<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Change legal entity type'\" :id=\"'change-le'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;curl&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/kyc-test.adyen.com\\\/lem\\\/v3\\\/legalEntities\\\/LE00000000000000000000001 \\\\\\n-H 'x-api-key: ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-X PATCH \\\\\\n-d '{\\n    \\&quot;type\\&quot;: \\&quot;organization\\&quot;\\n}'&quot;},{&quot;language&quot;:&quot;java&quot;,&quot;tabTitle&quot;:&quot;Java&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Java API Library v33.0.0\\nimport com.adyen.Client;\\nimport com.adyen.enums.Environment;\\nimport com.adyen.model.legalentitymanagement.*;\\nimport java.time.OffsetDateTime;\\nimport java.util.*;\\nimport com.adyen.service.legalEntityManagement.*;\\n\\nClient client = new Client(\\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;, Environment.TEST);\\n\\n\\\/\\\/ Create the request object(s)\\nLegalEntityInfo legalEntityInfo = new LegalEntityInfo()\\n  .type(LegalEntityInfo.TypeEnum.ORGANIZATION);\\n\\n\\\/\\\/ Send the request\\nLegalEntitiesApi service = new LegalEntitiesApi(client);\\nLegalEntity response = service.updateLegalEntity(\\&quot;id\\&quot;, legalEntityInfo, null);&quot;},{&quot;language&quot;:&quot;php&quot;,&quot;tabTitle&quot;:&quot;PHP&quot;,&quot;content&quot;:&quot;&lt;?php\\n\\\/\\\/ Adyen PHP API Library v24.0.0\\nuse Adyen\\\\Client;\\nuse Adyen\\\\Environment;\\nuse Adyen\\\\Model\\\\LegalEntityManagement\\\\LegalEntityInfo;\\nuse Adyen\\\\Service\\\\LegalEntityManagement\\\\LegalEntitiesApi;\\n\\n$client = new Client();\\n$client-&gt;setXApiKey(\\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;);\\n$client-&gt;setEnvironment(Environment::TEST);\\n\\n\\n\\\/\\\/ Create the request object(s)\\n$legalEntityInfo = new LegalEntityInfo();\\n$legalEntityInfo\\n  -&gt;setType(\\&quot;organization\\&quot;);\\n\\n\\\/\\\/ Send the request\\n$service = new LegalEntitiesApi($client);\\n$response = $service-&gt;updateLegalEntity('id', $legalEntityInfo);&quot;},{&quot;language&quot;:&quot;cs&quot;,&quot;tabTitle&quot;:&quot;C#&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen .net API Library v28.0.0\\nusing Adyen;\\nusing Environment = Adyen.Model.Environment;\\nusing Adyen.Model;\\nusing Adyen.Model.LegalEntityManagement;\\nusing Adyen.Service.LegalEntityManagement;\\n\\nvar config = new Config()\\n{\\n    XApiKey = \\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;,\\n    Environment = Environment.Test\\n};\\nvar client = new Client(config);\\n\\n\\\/\\\/ Create the request object(s)\\nLegalEntityInfo legalEntityInfo = new LegalEntityInfo\\n{\\n  Type = LegalEntityInfo.TypeEnum.Organization\\n};\\n\\n\\\/\\\/ Send the request\\nvar service = new LegalEntitiesService(client);\\nvar response = service.UpdateLegalEntity(\\&quot;id\\&quot;, legalEntityInfo);&quot;},{&quot;language&quot;:&quot;js&quot;,&quot;tabTitle&quot;:&quot;NodeJS (JavaScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v23.3.0\\nconst { Client, LegalEntityManagementAPI } = require('@adyen\\\/api-library');\\n\\nconst client = new Client({ apiKey: \\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot; });\\n\\n\\\/\\\/ Create the request object(s)\\nconst legalEntityInfo = {\\n  type: \\&quot;organization\\&quot;\\n}\\n\\n\\\/\\\/ Send the request\\nconst legalEntityManagementAPI = new LegalEntityManagementAPI(client);\\nconst response = legalEntityManagementAPI.LegalEntitiesApi.updateLegalEntity(\\&quot;id\\&quot;, legalEntityInfo);&quot;},{&quot;language&quot;:&quot;go&quot;,&quot;tabTitle&quot;:&quot;Go&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Go API Library v17.0.0\\nimport (\\n  \\&quot;context\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v17\\\/src\\\/common\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v17\\\/src\\\/adyen\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v17\\\/src\\\/legalEntityManagement\\&quot;\\n)\\nclient := adyen.NewClient(&amp;common.Config{\\n  ApiKey:      \\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;,\\n  Environment: common.TestEnv,\\n})\\n\\n\\\/\\\/ Create the request object(s)\\nlegalEntityInfo := legalEntityManagement.LegalEntityInfo{\\n  Type: common.PtrString(\\&quot;organization\\&quot;),\\n}\\n\\n\\\/\\\/ Send the request\\nservice := client.LegalEntityManagement()\\nreq := service.LegalEntitiesApi.UpdateLegalEntityInput(\\&quot;id\\&quot;).LegalEntityInfo(legalEntityInfo)\\nres, httpRes, err := service.LegalEntitiesApi.UpdateLegalEntity(context.Background(), req)&quot;},{&quot;language&quot;:&quot;py&quot;,&quot;tabTitle&quot;:&quot;Python&quot;,&quot;content&quot;:&quot;# Adyen Python API Library v13.3.0\\nimport Adyen\\n\\nadyen = Adyen.Adyen()\\nadyen.client.xapikey = \\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;\\nadyen.client.platform = \\&quot;test\\&quot; # The environment to use library in.\\n\\n# Create the request object(s)\\njson_request = {\\n  \\&quot;type\\&quot;: \\&quot;organization\\&quot;\\n}\\n\\n# Send the request\\nresult = adyen.legalEntityManagement.legal_entities_api.update_legal_entity(request=json_request, id=\\&quot;id\\&quot;)&quot;},{&quot;language&quot;:&quot;rb&quot;,&quot;tabTitle&quot;:&quot;Ruby&quot;,&quot;content&quot;:&quot;# Adyen Ruby API Library v10.1.1\\nrequire \\&quot;adyen-ruby-api-library\\&quot;\\n\\nadyen = Adyen::Client.new\\nadyen.api_key = 'ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY'\\nadyen.env = :test # Set to \\&quot;live\\&quot; for live environment\\n\\n# Create the request object(s)\\nrequest_body = {\\n  :type =&gt; 'organization'\\n}\\n\\n# Send the request\\nresult = adyen.legalEntityManagement.legal_entities_api.update_legal_entity(request_body, 'id')&quot;},{&quot;language&quot;:&quot;ts&quot;,&quot;tabTitle&quot;:&quot;NodeJS (TypeScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v23.3.0\\nimport { Client, LegalEntityManagementAPI, Types } from \\&quot;@adyen\\\/api-library\\&quot;;\\n\\nconst client = new Client({ apiKey: \\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot; });\\n\\n\\\/\\\/ Create the request object(s)\\nconst legalEntityInfo: Types.legalEntityManagement.LegalEntityInfo = {\\n  type: Types.legalEntityManagement.LegalEntityInfo.TypeEnum.Organization\\n};\\n\\n\\\/\\\/ Send the request\\nconst legalEntityManagementAPI = new LegalEntityManagementAPI(client);\\nconst response = legalEntityManagementAPI.LegalEntitiesApi.updateLegalEntity(\\&quot;id\\&quot;, legalEntityInfo);&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>The response contains the updated legal entity with some of the data migrated to the new type. To update additional information, for example, the complete address, make another PATCH  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/patch\/legalEntities\/(id)\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/legalEntities\/{id}<\/a> request.<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Response'\" :id=\"'change-le-response'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"organization\\\": {\\n        \\\"legalName\\\": \\\"Simone Hopper\\\",\\n        \\\"registeredAddress\\\": {\\n            \\\"country\\\": \\\"US\\\"\\n        }\\n    },\\n    \\\"type\\\": \\\"organization\\\",\\n    \\\"id\\\": \\\"LE00000000000000000000001\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<p>To change the legal entity type from an organization to a sole proprietorship:<\/p>\n<ol>\n<li>Change the legal entity type from organization to individual following the flow above.<\/li>\n<li>Make a PATCH  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/patch\/legalEntities\/(id)\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/legalEntities\/{id}<\/a> request and associate a sole proprietorship to the individual legal entity.<\/li>\n<\/ol>\n","url":"https:\/\/docs.adyen.com\/pt\/business-accounts\/manage-legal-entities","articleFields":{"description":"Create, view, and manage your users' legal entity resources.","feedback_component":true,"filters_component":false,"decision_tree":"[]","page_id":"d3590daa-8108-4943-8361-d18e3050baec","last_edit_on":"04-01-2024 17:37","parameters":{"directoryPath":"\/business-accounts","model":"balance platform"},"section_label":"Manage resources"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/business-accounts\/manage-legal-entities","title":"Manage legal entities","content":"A legal entity is an API resource that describes an individual or an organization on your Balance Platform. It contains information about your user, for example, the legal name, address, and tax information of the individual or organization. Adyen uses this information to perform verification checks as required by payment industry regulations.\nThe legal entity resource also contains the associations that the legal entity has with other entities on your platform. For example, most organizations need a signatory.\nTo manage legal entities, use the Legal Entity Management API.\nThis page contains instructions for common legal entity operations. These operations are part of a larger process which includes verification and onboarding steps.\nCreate a legal entity\nCreating a legal entity is the first step in moving users though the onboarding and verification process. Adyen uses the details you include when you create the legal entity to verify the account holder that is linked to the legal entity.\nThe minimum required information for creating a legal entity depends on the location and entity type that you are onboarding. \nTo create a legal entity:\n\n\nMake a POST  \/legalEntities request using the  individual or  organization details. The following example shows how to create an organization in the United States.\n\n\n\n\n\nThe response contains a generated legal entity id. Save this response because you need the ID to:\n\nCreate an account holder\nView a legal entity\nUpdate a legal entity\n\n\n\n\n\n\n\nView legal entity details\nAfter creating a legal entity, you can view the resource at any time using the Customer Area, the  Legal Entity Management API, or hosted onboarding.\n\n\n    \n        \n        \n    \n\n\nUpdate a legal entity\nWhen the details of your account holders change, you need to update the legal entity. For example, a business can change address or ownership. You can update a legal entity using the Customer Area or the  Legal Entity Management API.\n\n\n    \n        \n        \n    \n\n\nVerification checks will be run again when legal entity details are updated.\nChange legal entity type\nUsers sometimes sign up with an incorrect legal entity type. To change the legal entity type to the correct one, you can make a PATCH  \/legalEntities\/{id} request to update the legal entity type and then provide additional required information.\nAll verification checks are run again after the legal entity type is changed.\nYou can only change the type of the main legal entity. If the type of an associated legal entity is incorrect, you need to create a new legal entity.\nRetained information\nWhen you change the legal entity type, the following information is retained:\n\nThe legal entity id\nTransfer instruments\nBank statement details\nProof of industry\nProcessed amounts\nBusiness lines\n\nWhen changing between an individual and an organization legal entity, the following information is migrated:\n\nThe country is migrated from the individual residentialAddress to the organization registeredAddress.\nThe individual name is migrated to the organization legalName.\n\nWhen changing between an organization and an individual legal entity, the following information is migrated:\n\nThe country is migrated from the organization registeredAddress to the individual residentialAddress.\nThe organization legalName is migrated to the individual name.\n\nMake an API request\nYou can only directly change a legal entity type from:\n\nindividual to organization\norganization to individual\n\nThe example below shows how you can change a legal entity from an individual to an organization. Provide the new type in your PATCH  \/legalEntities\/{id} request:\n\n    \n\nThe response contains the updated legal entity with some of the data migrated to the new type. To update additional information, for example, the complete address, make another PATCH  \/legalEntities\/{id} request.\n\n    \n\nTo change the legal entity type from an organization to a sole proprietorship:\n\nChange the legal entity type from organization to individual following the flow above.\nMake a PATCH  \/legalEntities\/{id} request and associate a sole proprietorship to the individual legal entity.\n\n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Business accounts","lvl2":"Manage legal entities"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/business-accounts","lvl2":"\/pt\/business-accounts\/manage-legal-entities"},"levels":3,"category":"","category_color":"","tags":["Manage","legal","entities"]}}
