Create natural person
POST {{baseUrl}}/entities/natural-persons
Creates a new natural person containing the necessary identification data.
The ID must be unique across all entity types, therefore a natural-person cannot share the same ID as a legal-person
Dates must be passed in the YYYY-MM-DD format and countries as ISO 3166-1 Alpha-2 country codes. Additionally XX
is allowed for unknown states. Unicode character set is supported.
The KYC date should not be any older than 24 months since the contract signed date and once linked to a customer, the document should still be valid past the contracts signing dates.
The person's nationality should be filled in BOTH the core information AND the KYC document.
Example request: ```http-client POST https://api.tangany.com/customers/entities/natural-persons
{
id
: c3bd5c49-b7c2-480f-b1bc-2f80e77edb2d
,
firstName
: Elizabeth
,
lastName
: Henderson
,
birthDate
: 1977-04-14
,
birthPlace
: London
,
birthCountry
: GB
,
title
: Dr
,
gender
: F
,
birthName
: Henderson
,
nationality
: GB
,
address
: {
country
: GB
,
city
: SOUTHAMPTON
,
postcode
: SO53 5PD
,
streetName
: 71 Cherry Court
,
streetNumber
: A. 813
},
email
: elizabeth.henderson@example.com
,
phoneNumber
: +49123456789
,
mobilePhoneNumber
: +33987654321
,
kyc
: {
id
: 2deb4908-8af3-4388-9d24-6a3d0e508c4a
,
date
: 2020-05-01T13:15:45.000Z
,
method
: video_ident
,
document
: {
country
: GB
,
nationality
: GB
,
number
: GB123456789
,
issuedBy
: Home Office Identify & Passport Service
,
issueDate
: 2010-04-11
,
validUntil
: 2025-04-11
,
type
: id_card
}
},
}
```
Allowed roles : EDITOR, ONBOARDER and CREATOR
Request Body
{"id"=>"{{$guid}}", "firstName"=>"Elizabeth", "lastName"=>"Henderson", "birthDate"=>"1977-04-14", "birthPlace"=>"London", "title"=>"Dr", "gender"=>"F", "birthCountry"=>"GB", "birthName"=>"Henderson", "nationality"=>"GB", "address"=>{"country"=>"GB", "city"=>"SOUTHAMPTON", "postcode"=>"SO53 5PD", "streetName"=>"71 Cherry Court", "streetNumber"=>"A. 813"}, "email"=>"elizabeth.henderson@example.com", "phoneNumber"=>"+49123456789", "mobilePhoneNumber"=>"+33987654321", "selfDeclaredAsPep"=>false, "kyc"=>{"id"=>"2deb4908-8af3-4388-9d24-6a3d0e508c4a", "date"=>"2022-05-01T13:15:45.000Z", "method"=>"video_ident", "document"=>{"nationality"=>"GB", "country"=>"GB", "number"=>"GB123456789", "issuedBy"=>"Home Office Identify & Passport Service", "issueDate"=>"n/a", "validUntil"=>"2025-04-11", "type"=>"id_card", "iban"=>"DE89370400440532013000", "reference"=>"reference123456789"}}}
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","firstName":"Elizabeth","lastName":"Henderson","birthDate":"1977-04-14","birthPlace":"London","title":"Dr","gender":"F","birthCountry":"GB","birthName":"Henderson","nationality":"GB","address":{"country":"GB","city":"SOUTHAMPTON","postcode":"SO53 5PD","streetName":"71 Cherry Court","streetNumber":"A. 813"},"email":"elizabeth.henderson@example.com","phoneNumber":"+49123456789","mobilePhoneNumber":"+33987654321","selfDeclaredAsPep":false,"kyc":{"id":"2deb4908-8af3-4388-9d24-6a3d0e508c4a","date":"2022-05-01T13:15:45.000Z","method":"video_ident","document":{"nationality":"GB","country":"GB","number":"GB123456789","issuedBy":"Home Office Identify \u0026 Passport Service","issueDate":"n/a","validUntil":"2025-04-11","type":"id_card","iban":"DE89370400440532013000","reference":"reference123456789"}}}