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
Key | Datatype | Required | Description |
---|---|---|---|
tangany-version | number | (Required) API version | |
Content-Type | string | ||
Accept | string | ||
_tangany-data | string |
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"}}