Logo
Adyen APIs API Documentation

Associate an exempt settlor with a trust

PATCH {{baseUrl}}/legalEntities/:id

Updates a legal entity. >To change the legal entity type, include only the new type in your request. To update the entityAssociations array, you need to replace the entire array. For example, if the array has 3 entries and you want to remove 1 entry, you need to PATCH the resource with the remaining 2 entries.

 

Body PARAM

Key Datatype Required Description 



HEADERS

Key Datatype Required Description 
Content-Type
string
Accept
string
x-requested-verification-code
null Use the requested verification code 0_0001 to resolve any suberrors associated with the legal entity. Requested verification codes can only be used in your test environment.




RESPONSES

status OK

{ "entityAssociations": [{ "associatorId": "LE00000000000000000000001", "legalEntityId": "LE00000000000000000000002", "type": "settlor", "entityType": "individual", "settlorExemptionReason": ["deceased", "professionalServiceProvider"] }], "trust": { "name": "Example Trust", "type": "fixedUnitTrust", "doingBusinessAs": "West's Store", "countryOfGoverningLaw": "AU", "taxInformation": [{ "country": "AU", "type": "ABN", "number": "12345678901" }], "registeredAddress": { "street": "Winfield Avenue", "city": "Sydney", "postalCode": "1197", "stateOrProvince": "NSW", "country": "AU" }, "undefinedBeneficiaryInfo": [{ "description": "My future children" }] }, "type": "trust", "id": "LE00000000000000000000001" }

Curl
curl -X PATCH 'https://kyc-test.adyen.com/lem/v3/legalEntities/:id' -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'x-requested-verification-code: ' -d '{"entityAssociations":[{"legalEntityId":"LE00000000000000000000002","type":"settlor","entityType":"individual","settlorExemptionReason":["deceased","professionalServiceProvider"]}]}'

ENDPOINTS