Create legal person

POST {{baseUrl}}/entities/legal-persons

Creates a new legal person containing the necessary identification data.

The ID must be unique across all entity types, therefore a legal-person cannot share the same ID as a natural-person

Example request: ```http-client POST https://api.tangany.com/customers/entities/legal-persons

{ id: c3bd5c49-b7c2-480f-b1bc-2f80e77edb2d, name:Tangany GmbH, legalForm:GmbH, commercialRegister:Amtsgericht München HRB 246113, leiCode:529900WKXS5ZPJY9W498, taxId:894894, vatId:DE815805490, isinCode:DE000TANG015, legalJurisdiction:DE, legalAddress:{ country:DE, city:München, postcode:80992, streetName:Agnes-Pockels-Bogen, streetNumber:1 }, postalAddress:{ country:DE, city:München, postcode:80992, streetName:Agnes-Pockels-Bogen, streetNumber:1 }, kyc:{ businessDescription:crypto custody, isCreAvailable:false }, related:[ { entityId: e409aab1-58c4-4607-8657-8d805a9bb4a6, isFictitiousBeneficialOwner: false, isUltimateBeneficialOwner: true, position: CEO, sharePercentage: 100 } ], } ```

In addition to validation errors, this endpoint may respond with 422 Unprocessable entity error with one of the following error codes:

entity_not_found:

One of the provided entity ID was not found.

Allowed roles : EDITOR and CREATOR

Request Body

{"id"=>"{{$guid}}", "name"=>"Tangany GmbH", "legalForm"=>"GmbH", "legalAddress"=>{"country"=>"GB", "city"=>"SOUTHAMPTON", "postcode"=>"SO53 5PD", "streetName"=>"71 Cherry Court", "streetNumber"=>"A. 813"}, "related"=>[{"entityId"=>"{{entity-id}}", "isFictitiousBeneficialOwner"=>true, "isUltimateBeneficialOwner"=>false, "position"=>"dolore exercitation Duis non", "sharePercentage"=>"50"}], "commercialRegister"=>"Amtsgericht Munich HRB246113", "leiCode"=>"529900WKXS5ZPJY9W498", "taxId"=>"894894", "vatId"=>"DE815805490", "isinCode"=>"DE000TANG015", "legalJurisdiction"=>"DE", "postalAddress"=>{"country"=>"GB", "city"=>"SOUTHAMPTON", "postcode"=>"SO53 5PD", "streetName"=>"71 Cherry Court", "streetNumber"=>"A. 813"}, "kyc"=>{"isCreAvailable"=>false, "businessDescription"=>"crypto custody"}}

HEADERS

KeyDatatypeRequiredDescription
tangany-versionnumber(Required) API version
Content-Typestring
Acceptstring
_tangany-datastring

RESPONSES

status: OK

{"id":"78c483d7-5e6d-488b-981c-2ac4bccca2a5","name":"Tangany GmbH","legalForm":"GmbH","legalAddress":{"country":"GB","city":"SOUTHAMPTON","postcode":"SO53 5PD","streetName":"71 Cherry Court","streetNumber":"A. 813"},"related":[{"entityId":"sint consequat c","isFictitiousBeneficialOwner":true,"isUltimateBeneficialOwner":false,"position":"dolore exercitation Duis non","sharePercentage":"50"}],"commercialRegister":"Amtsgericht Munich HRB246113","leiCode":"529900WKXS5ZPJY9W498","taxId":"894894","vatId":"DE815805490","isinCode":"DE000TANG015","legalJurisdiction":"DE","postalAddress":{"country":"GB","city":"SOUTHAMPTON","postcode":"SO53 5PD","streetName":"71 Cherry Court","streetNumber":"A. 813"},"kyc":{"isCreAvailable":false,"businessDescription":"crypto custody"}}