Natural Persons
Create new natural person
Gender
Natural person first name
Natural person last name
Natural person middle name
Country code in ISO 3166-1 alpha-2 standard
Language code in ISO 639-1 two-letter codes (EU only)
FATCA - Question whether the customer is subject to US tax liability (nationality or other references due to a green card, registration address, etc.).
Annual income net
Available assets
External Id in partner's system. This value has to be unique
POST /natural-persons HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 947
{
"gender": "MALE",
"title": "PROFESSOR",
"firstName": "text",
"lastName": "text",
"middleName": "text",
"maritalStatus": "MARRIED",
"birthDay": "2025-07-10",
"birthPlace": "text",
"birthCountry": "AF",
"nationalities": [
{
"countryCode": "AF",
"nationalIdentifier": "text",
"nationalIdentifierType": "CONCAT"
}
],
"language": "da",
"taxDetails": [
{
"taxId": "text",
"taxResidency": "AF"
}
],
"isUsNationality": true,
"profession": "text",
"professionGroup": "EMPLOYED",
"naceSectors": [
{
"section": "text",
"description": "text"
}
],
"mainAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"correspondenceAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"annualIncomeNet": 1,
"sourceOfIncome": [
"INCOME_FROM_EMPLOYMENT"
],
"availableAssets": 1,
"originOfAssets": [
"NON_EMPLOYED_LABOR"
],
"contact": {
"phone": "text",
"email": "text",
"fax": "text",
"website": "text"
},
"externalId": "text"
}
{
"naturalPersonId": "123e4567-e89b-12d3-a456-426614174000"
}
Ready to test
Get natural persons
String value used for pagination
Maximum number of items to return
20
Natural person status Filter
Natural person role
GET /natural-persons HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": [
{
"roles": [
{
"roleName": "CUSTOMER",
"roleId": "123e4567-e89b-12d3-a456-426614174000",
"relatedCustomerId": "123e4567-e89b-12d3-a456-426614174000"
}
],
"deathDay": "2025-07-10",
"naturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
"globalId": "text",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"verifiedOn": "2025-07-10T02:52:58.798Z",
"isPep": true,
"isPepRelated": true,
"isSanction": true,
"naturalPersonStatus": "CREATED",
"naturalPersonIdentifications": [
{
"identificationId": "123e4567-e89b-12d3-a456-426614174000",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"externalVerifier": "WEB_ID",
"identificationType": "VIDEO_IDENT",
"identificationDate": "2025-07-10",
"identificationDocumentType": "ID",
"documentNumber": "text",
"documentCountry": "AF",
"documentIssuer": "text",
"documentIssueDate": "2025-07-10",
"documentExpiryDate": "2025-07-10",
"documentMotherFullName": "text",
"documentMotherResidenceCity": "text",
"documentFatherFullName": "text",
"documentFatherResidenceCity": "text"
}
],
"naturalPersonSignedDocuments": [
{
"partnerDocumentId": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"documentType": "TERMS_AND_CONDITIONS",
"version": 1,
"customerId": "123e4567-e89b-12d3-a456-426614174000",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z"
}
],
"gender": "MALE",
"title": "PROFESSOR",
"firstName": "text",
"lastName": "text",
"middleName": "text",
"maritalStatus": "MARRIED",
"birthDay": "2025-07-10",
"birthPlace": "text",
"birthCountry": "AF",
"nationalities": [
{
"countryCode": "AF",
"nationalIdentifier": "text",
"nationalIdentifierType": "CONCAT"
}
],
"language": "da",
"taxDetails": [
{
"taxId": "text",
"taxResidency": "AF"
}
],
"isUsNationality": true,
"profession": "text",
"professionGroup": "EMPLOYED",
"naceSectors": [
{
"section": "text",
"description": "text"
}
],
"mainAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"correspondenceAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"annualIncomeNet": 1,
"sourceOfIncome": [
"INCOME_FROM_EMPLOYMENT"
],
"availableAssets": 1,
"originOfAssets": [
"NON_EMPLOYED_LABOR"
],
"contact": {
"phone": "text",
"email": "text",
"fax": "text",
"website": "text"
},
"externalId": "text"
}
],
"pagination": {
"cursor": "text",
"limit": 1
}
}
Ready to test
Get natural person
Natural Person ID.
GET /natural-persons/{naturalPersonId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"roles": [
{
"roleName": "CUSTOMER",
"roleId": "123e4567-e89b-12d3-a456-426614174000",
"relatedCustomerId": "123e4567-e89b-12d3-a456-426614174000"
}
],
"deathDay": "2025-07-10",
"naturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
"globalId": "text",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"verifiedOn": "2025-07-10T02:52:58.798Z",
"isPep": true,
"isPepRelated": true,
"isSanction": true,
"naturalPersonStatus": "CREATED",
"naturalPersonIdentifications": [
{
"identificationId": "123e4567-e89b-12d3-a456-426614174000",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"externalVerifier": "WEB_ID",
"identificationType": "VIDEO_IDENT",
"identificationDate": "2025-07-10",
"identificationDocumentType": "ID",
"documentNumber": "text",
"documentCountry": "AF",
"documentIssuer": "text",
"documentIssueDate": "2025-07-10",
"documentExpiryDate": "2025-07-10",
"documentMotherFullName": "text",
"documentMotherResidenceCity": "text",
"documentFatherFullName": "text",
"documentFatherResidenceCity": "text"
}
],
"naturalPersonSignedDocuments": [
{
"partnerDocumentId": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"documentType": "TERMS_AND_CONDITIONS",
"version": 1,
"customerId": "123e4567-e89b-12d3-a456-426614174000",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z"
}
],
"gender": "MALE",
"title": "PROFESSOR",
"firstName": "text",
"lastName": "text",
"middleName": "text",
"maritalStatus": "MARRIED",
"birthDay": "2025-07-10",
"birthPlace": "text",
"birthCountry": "AF",
"nationalities": [
{
"countryCode": "AF",
"nationalIdentifier": "text",
"nationalIdentifierType": "CONCAT"
}
],
"language": "da",
"taxDetails": [
{
"taxId": "text",
"taxResidency": "AF"
}
],
"isUsNationality": true,
"profession": "text",
"professionGroup": "EMPLOYED",
"naceSectors": [
{
"section": "text",
"description": "text"
}
],
"mainAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"correspondenceAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"annualIncomeNet": 1,
"sourceOfIncome": [
"INCOME_FROM_EMPLOYMENT"
],
"availableAssets": 1,
"originOfAssets": [
"NON_EMPLOYED_LABOR"
],
"contact": {
"phone": "text",
"email": "text",
"fax": "text",
"website": "text"
},
"externalId": "text"
}
Ready to test
Update natural person
Natural Person ID.
Unique requestor identification in UUID format
Document ID in UUID format for those params where a document upload is required (title, lastName, deathDay)
PATCH /natural-persons/{naturalPersonId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 893
{
"naturalPersonUpdateData": {
"annualIncomeNet": 1,
"sourceOfIncome": [
"INCOME_FROM_EMPLOYMENT"
],
"availableAssets": 1,
"originOfAssets": [
"NON_EMPLOYED_LABOR"
],
"contact": {
"phone": "text",
"email": "text",
"fax": "text",
"website": "text"
},
"mainAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"correspondenceAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"title": "PROFESSOR",
"lastName": "text",
"maritalStatus": "MARRIED",
"profession": "text",
"professionGroup": "EMPLOYED",
"naceSectors": [
{
"section": "text",
"description": "text"
}
],
"taxDetails": [
{
"taxId": "text",
"taxResidency": "AF"
}
],
"nationalities": [
{
"countryCode": "AF",
"nationalIdentifier": "text",
"nationalIdentifierType": "CONCAT"
}
],
"externalId": "text",
"deathDay": "2025-07-10"
},
"documentId": "123e4567-e89b-12d3-a456-426614174000"
}
No content
Ready to test
Create new natural person identification
Unique requestor identification in UUID format
The legal name of the vendor/company performing the identification for this natural person
Method used to identify the customer
Date on which the identification was carried out. The date must be within the last 24 months.
Type of the identification document which has been used for identification of the natural person.
Document number of the identification document.
Issuing country of the identification document.
Issuing authority of the identification document
Issue date of the identification document
Expiry date of the identification document. If the identification document is a birth certificate, the date on which the person comes of age must be entered as the expiry date.
Full name of the mother, only mandatory for identificationDocumentType = BIRTH_CERTIFICATE
Residence city of the mother, only mandatory for identificationDocumentType = BIRTH_CERTIFICATE
Full name of the father, only mandatory for identificationDocumentType = BIRTH_CERTIFICATE
Residence city of the father, only mandatory for identificationDocumentType = BIRTH_CERTIFICATE
POST /natural-persons/{naturalPersonId}/identification HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 408
{
"externalVerifier": "WEB_ID",
"identificationType": "VIDEO_IDENT",
"identificationDate": "2025-07-10",
"identificationDocumentType": "ID",
"documentNumber": "text",
"documentCountry": "AF",
"documentIssuer": "text",
"documentIssueDate": "2025-07-10",
"documentExpiryDate": "2025-07-10",
"documentMotherFullName": "text",
"documentMotherResidenceCity": "text",
"documentFatherFullName": "text",
"documentFatherResidenceCity": "text"
}
No content
Ready to test
Create Identification Verification
After successful request link to a video call should be retrieved with Get Identification Verification endpoint from identificationUrl
field of the response.
Currently only externalVerifier = WEB_ID and identificationType = VIDEO_IDENT is supported.
Unique requestor identification in UUID format
The legal name of the vendor/company performing the identification for this natural person
Method used to identify the customer
POST /identification-verifications HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 121
{
"naturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
"externalVerifier": "WEB_ID",
"identificationType": "VIDEO_IDENT"
}
{
"identificationVerificationId": "123e4567-e89b-12d3-a456-426614174000"
}
Ready to test
Get Identification Verifications
String value used for pagination
Maximum number of items to return
20
Unique requestor identification in UUID format
GET /identification-verifications HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Accept: */*
{
"data": [
{
"naturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
"identificationVerificationId": "123e4567-e89b-12d3-a456-426614174000",
"externalVerifier": "WEB_ID",
"identificationType": "VIDEO_IDENT",
"identificationUrl": "text",
"documentId": "123e4567-e89b-12d3-a456-426614174000",
"naturalPersonIdentificationId": "123e4567-e89b-12d3-a456-426614174000",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"status": "RECEIVED"
}
],
"pagination": {
"cursor": "text",
"limit": 1
}
}
Ready to test
Get Identification Verification
Unique requestor identification in UUID format
GET /identification-verifications/{identificationVerificationId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Accept: */*
{
"naturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
"identificationVerificationId": "123e4567-e89b-12d3-a456-426614174000",
"externalVerifier": "WEB_ID",
"identificationType": "VIDEO_IDENT",
"identificationUrl": "text",
"documentId": "123e4567-e89b-12d3-a456-426614174000",
"naturalPersonIdentificationId": "123e4567-e89b-12d3-a456-426614174000",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"status": "RECEIVED"
}
Ready to test
Create new natural person type customer
Unique requestor identification in UUID format
Identifier for the associated Natural Person.
Up to 16 user-defined labels can be provided to allow grouping of customers as per required logic
POST /customers/natural-persons HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 175
{
"naturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
"labels": [
"text"
],
"refAccounts": [
{
"bankName": "text",
"iban": "text",
"bic": "text",
"type": "PRIMARY",
"ownerName": "text"
}
]
}
{
"customerId": "123e4567-e89b-12d3-a456-426614174000"
}
Ready to test
Update existing natural person type customer
Unique customer identification number in UUID format
Unique requestor identification in UUID format
Annual income net
Available assets
Natural person last name
Up to 16 user-defined labels can be provided to allow grouping of customers as per required logic
PATCH /customers/natural-persons/{customerId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 910
{
"annualIncomeNet": 1,
"sourceOfIncome": [
"INCOME_FROM_EMPLOYMENT"
],
"availableAssets": 1,
"originOfAssets": [
"NON_EMPLOYED_LABOR"
],
"contact": {
"phone": "text",
"email": "text",
"fax": "text",
"website": "text"
},
"mainAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"correspondenceAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"title": "PROFESSOR",
"lastName": "text",
"maritalStatus": "MARRIED",
"profession": "text",
"professionGroup": "EMPLOYED",
"naceSectors": [
{
"section": "text",
"description": "text"
}
],
"taxDetails": [
{
"taxId": "text",
"taxResidency": "AF"
}
],
"nationalities": [
{
"countryCode": "AF",
"nationalIdentifier": "text",
"nationalIdentifierType": "CONCAT"
}
],
"deathDay": "2025-07-10",
"labels": [
"text"
],
"refAccounts": [
{
"bankName": "text",
"iban": "text",
"bic": "text",
"type": "PRIMARY",
"ownerName": "text"
}
]
}
No content
Ready to test
Get natural person type customer
Unique customer identification number in UUID format
GET /customers/natural-persons/{customerId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"customerId": "123e4567-e89b-12d3-a456-426614174000",
"customerStatus": "CREATED",
"customerType": "NATURAL_PERSON",
"signedDocumentsRelatedToCustomer": [
{
"partnerDocumentId": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"documentType": "TERMS_AND_CONDITIONS",
"version": 1,
"naturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
"naturalPersonFullName": "text",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z"
}
],
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"approvedOn": "2025-07-10T02:52:58.798Z",
"cancellationDate": "2025-07-10T02:52:58.798Z",
"naturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
"labels": [
"text"
],
"refAccounts": [
{
"bankName": "text",
"iban": "text",
"bic": "text",
"type": "PRIMARY",
"ownerName": "text"
}
],
"naturalPerson": {
"deathDay": "2025-07-10",
"naturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
"globalId": "text",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"verifiedOn": "2025-07-10T02:52:58.798Z",
"isPep": true,
"isPepRelated": true,
"isSanction": true,
"naturalPersonStatus": "CREATED",
"naturalPersonIdentifications": [
{
"identificationId": "123e4567-e89b-12d3-a456-426614174000",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"externalVerifier": "WEB_ID",
"identificationType": "VIDEO_IDENT",
"identificationDate": "2025-07-10",
"identificationDocumentType": "ID",
"documentNumber": "text",
"documentCountry": "AF",
"documentIssuer": "text",
"documentIssueDate": "2025-07-10",
"documentExpiryDate": "2025-07-10",
"documentMotherFullName": "text",
"documentMotherResidenceCity": "text",
"documentFatherFullName": "text",
"documentFatherResidenceCity": "text"
}
],
"naturalPersonSignedDocuments": [
{
"partnerDocumentId": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"documentType": "TERMS_AND_CONDITIONS",
"version": 1,
"customerId": "123e4567-e89b-12d3-a456-426614174000",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z"
}
],
"gender": "MALE",
"title": "PROFESSOR",
"firstName": "text",
"lastName": "text",
"middleName": "text",
"maritalStatus": "MARRIED",
"birthDay": "2025-07-10",
"birthPlace": "text",
"birthCountry": "AF",
"nationalities": [
{
"countryCode": "AF",
"nationalIdentifier": "text",
"nationalIdentifierType": "CONCAT"
}
],
"language": "da",
"taxDetails": [
{
"taxId": "text",
"taxResidency": "AF"
}
],
"isUsNationality": true,
"profession": "text",
"professionGroup": "EMPLOYED",
"naceSectors": [
{
"section": "text",
"description": "text"
}
],
"mainAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"correspondenceAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"annualIncomeNet": 1,
"sourceOfIncome": [
"INCOME_FROM_EMPLOYMENT"
],
"availableAssets": 1,
"originOfAssets": [
"NON_EMPLOYED_LABOR"
],
"contact": {
"phone": "text",
"email": "text",
"fax": "text",
"website": "text"
},
"externalId": "text"
}
}
Assign natural persons the role of authorized proxy.
Unique requestor identification in UUID format
Identifier of the customer, joint person customer or legal entity customer, who will be managed by the proxy.
IDs of the customers products for which the proxy is allowed to take actions in behalf of the customer (multiple products possible).
Defines the period of validity of the power of proxy.
Only mandatory for proxyType SIGNATORY
Defines the scope of the power of representation, which is dependent on the underlying signature authorisation of the legal representative:
- INDIVIDUAL: If soleSignatureAuthorized of the legal representative = YES
- JOINT: If soleSignatureAuthorized of the legal representative = NO
Only mandatory for proxyType GUARDIAN
.
Specifies the type of custody associated with the guardian.
SINGLE_CUSTODY
: Indicates that only one guardian holds legal and physical custody of the child.JOINT_CUSTODY
: Indicates that the custody of the child is shared between two guardians, typically implying both have legal rights concerning the child's upbringing.
POST /natural-persons/{naturalPersonId}/proxy HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 248
{
"proxyType": "GENERAL_POWER_OF_ATTORNEY",
"customerId": "123e4567-e89b-12d3-a456-426614174000",
"customerProductIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"validityType": "UNTIL_CASE_OF_DEATH",
"scopeType": "INDIVIDUAL",
"custodyType": "SINGLE_CUSTODY"
}
{
"proxyId": "123e4567-e89b-12d3-a456-426614174000"
}
Get a list of proxies.
String value used for pagination
Maximum number of items to return
20
Proxy type filter
Defines the period of validity of the power of proxy.
Proxy status Filter
proxy search text, the search will be performed on the following fields: name of natural person, proxyId, customerId, naturalPersonId
Unique customer identification number in UUID format
Unique natural person identification number in UUID format
IDs of the customers products for which the proxy is allowed to take actions in behalf of the customer (multiple products possible).
GET /proxies HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": [
{
"proxyId": "123e4567-e89b-12d3-a456-426614174000",
"proxyStatus": "CREATED",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"proxyType": "GENERAL_POWER_OF_ATTORNEY",
"naturalPerson": {
"deathDay": "2025-07-10",
"naturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
"globalId": "text",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"verifiedOn": "2025-07-10T02:52:58.798Z",
"isPep": true,
"isPepRelated": true,
"isSanction": true,
"naturalPersonStatus": "CREATED",
"naturalPersonIdentifications": [
{
"identificationId": "123e4567-e89b-12d3-a456-426614174000",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"externalVerifier": "WEB_ID",
"identificationType": "VIDEO_IDENT",
"identificationDate": "2025-07-10",
"identificationDocumentType": "ID",
"documentNumber": "text",
"documentCountry": "AF",
"documentIssuer": "text",
"documentIssueDate": "2025-07-10",
"documentExpiryDate": "2025-07-10",
"documentMotherFullName": "text",
"documentMotherResidenceCity": "text",
"documentFatherFullName": "text",
"documentFatherResidenceCity": "text"
}
],
"naturalPersonSignedDocuments": [
{
"partnerDocumentId": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"documentType": "TERMS_AND_CONDITIONS",
"version": 1,
"customerId": "123e4567-e89b-12d3-a456-426614174000",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z"
}
],
"gender": "MALE",
"title": "PROFESSOR",
"firstName": "text",
"lastName": "text",
"middleName": "text",
"maritalStatus": "MARRIED",
"birthDay": "2025-07-10",
"birthPlace": "text",
"birthCountry": "AF",
"nationalities": [
{
"countryCode": "AF",
"nationalIdentifier": "text",
"nationalIdentifierType": "CONCAT"
}
],
"language": "da",
"taxDetails": [
{
"taxId": "text",
"taxResidency": "AF"
}
],
"isUsNationality": true,
"profession": "text",
"professionGroup": "EMPLOYED",
"naceSectors": [
{
"section": "text",
"description": "text"
}
],
"mainAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"correspondenceAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"annualIncomeNet": 1,
"sourceOfIncome": [
"INCOME_FROM_EMPLOYMENT"
],
"availableAssets": 1,
"originOfAssets": [
"NON_EMPLOYED_LABOR"
],
"contact": {
"phone": "text",
"email": "text",
"fax": "text",
"website": "text"
},
"externalId": "text"
},
"customerId": "123e4567-e89b-12d3-a456-426614174000",
"customerProductIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"validityType": "UNTIL_CASE_OF_DEATH",
"scopeType": "INDIVIDUAL",
"custodyType": "SINGLE_CUSTODY"
}
],
"pagination": {
"cursor": "text",
"limit": 1
}
}
Ready to test
Get proxy
Unique proxy identification number in UUID format
GET /proxies/{proxyId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"proxyId": "123e4567-e89b-12d3-a456-426614174000",
"proxyStatus": "CREATED",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"proxyType": "GENERAL_POWER_OF_ATTORNEY",
"naturalPerson": {
"deathDay": "2025-07-10",
"naturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
"globalId": "text",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"verifiedOn": "2025-07-10T02:52:58.798Z",
"isPep": true,
"isPepRelated": true,
"isSanction": true,
"naturalPersonStatus": "CREATED",
"naturalPersonIdentifications": [
{
"identificationId": "123e4567-e89b-12d3-a456-426614174000",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"externalVerifier": "WEB_ID",
"identificationType": "VIDEO_IDENT",
"identificationDate": "2025-07-10",
"identificationDocumentType": "ID",
"documentNumber": "text",
"documentCountry": "AF",
"documentIssuer": "text",
"documentIssueDate": "2025-07-10",
"documentExpiryDate": "2025-07-10",
"documentMotherFullName": "text",
"documentMotherResidenceCity": "text",
"documentFatherFullName": "text",
"documentFatherResidenceCity": "text"
}
],
"naturalPersonSignedDocuments": [
{
"partnerDocumentId": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"documentType": "TERMS_AND_CONDITIONS",
"version": 1,
"customerId": "123e4567-e89b-12d3-a456-426614174000",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z"
}
],
"gender": "MALE",
"title": "PROFESSOR",
"firstName": "text",
"lastName": "text",
"middleName": "text",
"maritalStatus": "MARRIED",
"birthDay": "2025-07-10",
"birthPlace": "text",
"birthCountry": "AF",
"nationalities": [
{
"countryCode": "AF",
"nationalIdentifier": "text",
"nationalIdentifierType": "CONCAT"
}
],
"language": "da",
"taxDetails": [
{
"taxId": "text",
"taxResidency": "AF"
}
],
"isUsNationality": true,
"profession": "text",
"professionGroup": "EMPLOYED",
"naceSectors": [
{
"section": "text",
"description": "text"
}
],
"mainAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"correspondenceAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"annualIncomeNet": 1,
"sourceOfIncome": [
"INCOME_FROM_EMPLOYMENT"
],
"availableAssets": 1,
"originOfAssets": [
"NON_EMPLOYED_LABOR"
],
"contact": {
"phone": "text",
"email": "text",
"fax": "text",
"website": "text"
},
"externalId": "text"
},
"customerId": "123e4567-e89b-12d3-a456-426614174000",
"customerProductIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"validityType": "UNTIL_CASE_OF_DEATH",
"scopeType": "INDIVIDUAL",
"custodyType": "SINGLE_CUSTODY"
}
Ready to test
Update proxy
Unique proxy identification number in UUID format
Unique requestor identification in UUID format
Document ID in UUID format for those params where a document upload is required (scopeType, custodyType)
PATCH /proxies/{proxyId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 228
{
"proxyUpdateData": {
"customerProductIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"validityType": "UNTIL_CASE_OF_DEATH",
"scopeType": "INDIVIDUAL",
"custodyType": "SINGLE_CUSTODY"
},
"documentId": "123e4567-e89b-12d3-a456-426614174000"
}
No content
Ready to test
Create new joint person customer
Unique requestor identification in UUID format
Annual income net
Available assets
Identifier for the first Natural Person
Identifier for the second Natural Person
POST /customers/joint-persons HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 671
{
"mainAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"correspondenceAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"annualIncomeNet": 1,
"sourceOfIncome": [
"INCOME_FROM_EMPLOYMENT"
],
"availableAssets": 1,
"originOfAssets": [
"NON_EMPLOYED_LABOR"
],
"firstNaturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
"secondNaturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
"contact": {
"phone": "text",
"email": "text",
"fax": "text",
"website": "text"
},
"refAccounts": [
{
"bankName": "text",
"iban": "text",
"bic": "text",
"type": "PRIMARY",
"ownerName": "text"
}
]
}
{
"customerId": "123e4567-e89b-12d3-a456-426614174000"
}
Update existing joint person type customer
Unique customer identification number in UUID format
Unique requestor identification in UUID format
Annual income net
Available assets
PATCH /customers/joint-persons/{customerId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 546
{
"annualIncomeNet": 1,
"sourceOfIncome": [
"INCOME_FROM_EMPLOYMENT"
],
"availableAssets": 1,
"originOfAssets": [
"NON_EMPLOYED_LABOR"
],
"contact": {
"phone": "text",
"email": "text",
"fax": "text",
"website": "text"
},
"mainAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"correspondenceAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"refAccounts": [
{
"bankName": "text",
"iban": "text",
"bic": "text",
"type": "PRIMARY",
"ownerName": "text"
}
]
}
No content
Ready to test
Get joint person type customer
Unique customer identification number in UUID format
GET /customers/joint-persons/{customerId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"customerId": "123e4567-e89b-12d3-a456-426614174000",
"customerStatus": "CREATED",
"customerType": "NATURAL_PERSON",
"signedDocumentsRelatedToCustomer": [
{
"partnerDocumentId": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"documentType": "TERMS_AND_CONDITIONS",
"version": 1,
"naturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
"naturalPersonFullName": "text",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z"
}
],
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"approvedOn": "2025-07-10T02:52:58.798Z",
"cancellationDate": "2025-07-10T02:52:58.798Z",
"mainAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"correspondenceAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"annualIncomeNet": 1,
"sourceOfIncome": [
"INCOME_FROM_EMPLOYMENT"
],
"availableAssets": 1,
"originOfAssets": [
"NON_EMPLOYED_LABOR"
],
"firstNaturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
"secondNaturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
"contact": {
"phone": "text",
"email": "text",
"fax": "text",
"website": "text"
},
"refAccounts": [
{
"bankName": "text",
"iban": "text",
"bic": "text",
"type": "PRIMARY",
"ownerName": "text"
}
],
"globalId": "text",
"firstNaturalPerson": {
"deathDay": "2025-07-10",
"naturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
"globalId": "text",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"verifiedOn": "2025-07-10T02:52:58.798Z",
"isPep": true,
"isPepRelated": true,
"isSanction": true,
"naturalPersonStatus": "CREATED",
"naturalPersonIdentifications": [
{
"identificationId": "123e4567-e89b-12d3-a456-426614174000",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"externalVerifier": "WEB_ID",
"identificationType": "VIDEO_IDENT",
"identificationDate": "2025-07-10",
"identificationDocumentType": "ID",
"documentNumber": "text",
"documentCountry": "AF",
"documentIssuer": "text",
"documentIssueDate": "2025-07-10",
"documentExpiryDate": "2025-07-10",
"documentMotherFullName": "text",
"documentMotherResidenceCity": "text",
"documentFatherFullName": "text",
"documentFatherResidenceCity": "text"
}
],
"naturalPersonSignedDocuments": [
{
"partnerDocumentId": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"documentType": "TERMS_AND_CONDITIONS",
"version": 1,
"customerId": "123e4567-e89b-12d3-a456-426614174000",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z"
}
],
"gender": "MALE",
"title": "PROFESSOR",
"firstName": "text",
"lastName": "text",
"middleName": "text",
"maritalStatus": "MARRIED",
"birthDay": "2025-07-10",
"birthPlace": "text",
"birthCountry": "AF",
"nationalities": [
{
"countryCode": "AF",
"nationalIdentifier": "text",
"nationalIdentifierType": "CONCAT"
}
],
"language": "da",
"taxDetails": [
{
"taxId": "text",
"taxResidency": "AF"
}
],
"isUsNationality": true,
"profession": "text",
"professionGroup": "EMPLOYED",
"naceSectors": [
{
"section": "text",
"description": "text"
}
],
"mainAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"correspondenceAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"annualIncomeNet": 1,
"sourceOfIncome": [
"INCOME_FROM_EMPLOYMENT"
],
"availableAssets": 1,
"originOfAssets": [
"NON_EMPLOYED_LABOR"
],
"contact": {
"phone": "text",
"email": "text",
"fax": "text",
"website": "text"
},
"externalId": "text"
},
"secondNaturalPerson": {
"deathDay": "2025-07-10",
"naturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
"globalId": "text",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"verifiedOn": "2025-07-10T02:52:58.798Z",
"isPep": true,
"isPepRelated": true,
"isSanction": true,
"naturalPersonStatus": "CREATED",
"naturalPersonIdentifications": [
{
"identificationId": "123e4567-e89b-12d3-a456-426614174000",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"externalVerifier": "WEB_ID",
"identificationType": "VIDEO_IDENT",
"identificationDate": "2025-07-10",
"identificationDocumentType": "ID",
"documentNumber": "text",
"documentCountry": "AF",
"documentIssuer": "text",
"documentIssueDate": "2025-07-10",
"documentExpiryDate": "2025-07-10",
"documentMotherFullName": "text",
"documentMotherResidenceCity": "text",
"documentFatherFullName": "text",
"documentFatherResidenceCity": "text"
}
],
"naturalPersonSignedDocuments": [
{
"partnerDocumentId": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"documentType": "TERMS_AND_CONDITIONS",
"version": 1,
"customerId": "123e4567-e89b-12d3-a456-426614174000",
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z"
}
],
"gender": "MALE",
"title": "PROFESSOR",
"firstName": "text",
"lastName": "text",
"middleName": "text",
"maritalStatus": "MARRIED",
"birthDay": "2025-07-10",
"birthPlace": "text",
"birthCountry": "AF",
"nationalities": [
{
"countryCode": "AF",
"nationalIdentifier": "text",
"nationalIdentifierType": "CONCAT"
}
],
"language": "da",
"taxDetails": [
{
"taxId": "text",
"taxResidency": "AF"
}
],
"isUsNationality": true,
"profession": "text",
"professionGroup": "EMPLOYED",
"naceSectors": [
{
"section": "text",
"description": "text"
}
],
"mainAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"correspondenceAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"annualIncomeNet": 1,
"sourceOfIncome": [
"INCOME_FROM_EMPLOYMENT"
],
"availableAssets": 1,
"originOfAssets": [
"NON_EMPLOYED_LABOR"
],
"contact": {
"phone": "text",
"email": "text",
"fax": "text",
"website": "text"
},
"externalId": "text"
}
}
Ready to test
Creates a new beneficial owner
Path Parameter:
customerId
: The ID of the customer to whom the beneficial owner will be assigned.
Payload:
Details for the new beneficial owner, such as first name, last name, etc.
Upon successful execution, a new beneficial owner will be created and stored, independent of any existing customer records.
The UUID of the customer for whom the beneficial owner will be designated.
Unique requestor identification in UUID format
Natural person first name
Natural person last name
Natural person middle name
Location
Country code in ISO 3166-1 alpha-2 standard
FATCA - Question whether the customer is subject to US tax liability (nationality or other references due to a green card, registration address, etc.).
Indication of the type of beneficial owner:
In the context of legal entity customers:
REAL_UBO_25
= person who holds more than 25% of the company shares
FICTIVE_UBO
= Legal Representative, if no person exists who holds more than 25% of the company shares
Only mandatory if boType = REAL_UBO_25
Only mandatory if boType = REAL_UBO_25
Indication of whether this person is a controlling person under FATCA.
TRUE
= if fatcaClassification = PASSIVE_NFE
POST /customers/natural-persons/{customerId}/beneficial-owners HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 521
{
"firstName": "text",
"lastName": "text",
"middleName": "text",
"birthDay": "2025-07-10",
"birthPlace": "text",
"birthCountry": "AF",
"taxDetails": [
{
"taxId": "text",
"taxResidency": "AF"
}
],
"isUsNationality": true,
"mainAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"nationalities": [
{
"countryCode": "AF",
"nationalIdentifier": "text",
"nationalIdentifierType": "CONCAT"
}
],
"boType": "FICTIVE_UBO",
"uboRelationship": "DIRECTLY_HOLDING_25",
"share": 1,
"fatcaControllingPerson": true
}
{
"beneficialOwnerId": "123e4567-e89b-12d3-a456-426614174000"
}
Ready to test
Get beneficial owners of a customer
The UUID of the customer for whom the beneficial owner will be designated.
String value used for pagination
Maximum number of items to return
20
beneficial owner status filter
Beginning of the range. Beneficial owner create date time is after this parameter.
End of the range. Beneficial owner create date time is before this parameter.
GET /customers/natural-persons/{customerId}/beneficial-owners HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"data": [
{
"firstName": "text",
"lastName": "text",
"middleName": "text",
"birthDay": "2025-07-10",
"birthPlace": "text",
"birthCountry": "AF",
"taxDetails": [
{
"taxId": "text",
"taxResidency": "AF"
}
],
"isUsNationality": true,
"mainAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"nationalities": [
{
"countryCode": "AF",
"nationalIdentifier": "text",
"nationalIdentifierType": "CONCAT"
}
],
"boType": "FICTIVE_UBO",
"uboRelationship": "DIRECTLY_HOLDING_25",
"share": 1,
"fatcaControllingPerson": true,
"deathDay": "2025-07-10",
"beneficialOwnerId": "123e4567-e89b-12d3-a456-426614174000",
"globalId": "text",
"status": "CREATED",
"isPep": true,
"isPepRelated": true,
"isSanction": true,
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"verifiedOn": "2025-07-10T02:52:58.798Z"
}
],
"pagination": {
"cursor": "text",
"limit": 1
}
}
Ready to test
Get beneficial owner of a customer
The UUID of the customer for whom the beneficial owner will be designated.
The UUID of the beneficial owner
GET /customers/natural-persons/{customerId}/beneficial-owners/{beneficialOwnerId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"firstName": "text",
"lastName": "text",
"middleName": "text",
"birthDay": "2025-07-10",
"birthPlace": "text",
"birthCountry": "AF",
"taxDetails": [
{
"taxId": "text",
"taxResidency": "AF"
}
],
"isUsNationality": true,
"mainAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"nationalities": [
{
"countryCode": "AF",
"nationalIdentifier": "text",
"nationalIdentifierType": "CONCAT"
}
],
"boType": "FICTIVE_UBO",
"uboRelationship": "DIRECTLY_HOLDING_25",
"share": 1,
"fatcaControllingPerson": true,
"deathDay": "2025-07-10",
"beneficialOwnerId": "123e4567-e89b-12d3-a456-426614174000",
"globalId": "text",
"status": "CREATED",
"isPep": true,
"isPepRelated": true,
"isSanction": true,
"createdOn": "2025-07-10T02:52:58.798Z",
"modifiedOn": "2025-07-10T02:52:58.798Z",
"verifiedOn": "2025-07-10T02:52:58.798Z"
}
Ready to test
Update existing beneficial owner
The UUID of the customer for whom the beneficial owner will be designated.
The UUID of the beneficial owner
Unique requestor identification in UUID format
Natural person first name
Natural person last name
Natural person middle name
Location
Country code in ISO 3166-1 alpha-2 standard
FATCA - Question whether the customer is subject to US tax liability (nationality or other references due to a green card, registration address, etc.).
Indication of the type of beneficial owner:
In the context of legal entity customers:
REAL_UBO_25
= person who holds more than 25% of the company shares
FICTIVE_UBO
= Legal Representative, if no person exists who holds more than 25% of the company shares
Only mandatory if boType = REAL_UBO_25
Indication of whether this person is a controlling person under FATCA.
TRUE
= if fatcaClassification = PASSIVE_NFE
PATCH /customers/natural-persons/{customerId}/beneficial-owners/{beneficialOwnerId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 521
{
"firstName": "text",
"lastName": "text",
"middleName": "text",
"birthDay": "2025-07-10",
"birthPlace": "text",
"birthCountry": "AF",
"taxDetails": [
{
"taxId": "text",
"taxResidency": "AF"
}
],
"isUsNationality": true,
"mainAddress": {
"street": "text",
"streetNumber": "text",
"city": "text",
"zip": "text",
"country": "AF",
"additionalInfo": "text"
},
"nationalities": [
{
"countryCode": "AF",
"nationalIdentifier": "text",
"nationalIdentifierType": "CONCAT"
}
],
"boType": "FICTIVE_UBO",
"uboRelationship": "DIRECTLY_HOLDING_25",
"share": 1,
"fatcaControllingPerson": true
}
No content
Last updated