Legal Representatives

Create Legal Representative

post

Create new legal representative

Authorizations
Path parameters
legalEntityIdstring · uuidRequired

Legal Entity ID

Header parameters
Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body
firstNamestring · min: 1 · max: 255Required

All first names of the person according to the identification document

Pattern: ^\S+( \S+)*$
lastNamestring · min: 1 · max: 255Required

Natural person last name

birthDaystring · dateRequired
birthPlacestring · min: 1 · max: 255Required

Location

birthCountrystring · enumRequired

Country code in ISO 3166-1 alpha-2 standard

Possible values:
isUsNationalitybooleanRequired

FATCA - Question whether the customer is subject to US tax liability (nationality or other references due to a green card, registration address, etc.).

functionstring · enumRequiredPossible values:
soleSignatureAuthorizedbooleanRequired

Indication of whether or not the legal representative is authorized to represent the company individually.

fatcaControllingPersonbooleanRequired

Indication of whether this person is a controlling person under FATCA.
TRUE = if fatcaClassification = PASSIVE_NFE

Responses
200

OK

application/json
post
POST /entities/{legalEntityId}/legal-representatives 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: 438

{
  "firstName": "text",
  "lastName": "text",
  "birthDay": "2025-08-29",
  "birthPlace": "text",
  "birthCountry": "AF",
  "taxDetails": [
    {
      "taxId": "text",
      "taxResidency": "AF",
      "noTinConfirmation": false
    }
  ],
  "isUsNationality": true,
  "mainAddress": {
    "street": "text",
    "streetNumber": "text",
    "city": "text",
    "zip": "text",
    "country": "AF",
    "additionalInfo": "text"
  },
  "nationalities": [
    "AF"
  ],
  "function": "MANAGING_DIRECTOR",
  "soleSignatureAuthorized": true,
  "fatcaControllingPerson": true
}
{
  "legalRepresentativeId": "123e4567-e89b-12d3-a456-426614174000"
}

Get Legal Representatives

get

Get legal representatives

Authorizations
Path parameters
legalEntityIdstring · uuidRequired

Legal Entity ID

Query parameters
cursorstringOptional

String value used for pagination

limitinteger · min: 1Required

Maximum number of items to return

Default: 20
legalRepresentativeStatusstring · enumOptional

Legal representative status Filter

Possible values:
startDatestring · date-timeOptional

Beginning of the range

endDatestring · date-timeOptional

End of the range

Responses
200

OK

application/json
get
GET /entities/{legalEntityId}/legal-representatives HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "data": [
    {
      "firstName": "text",
      "lastName": "text",
      "birthDay": "2025-08-29",
      "birthPlace": "text",
      "birthCountry": "AF",
      "taxDetails": [
        {
          "taxId": "text",
          "taxResidency": "AF",
          "noTinConfirmation": false
        }
      ],
      "isUsNationality": true,
      "mainAddress": {
        "street": "text",
        "streetNumber": "text",
        "city": "text",
        "zip": "text",
        "country": "AF",
        "additionalInfo": "text"
      },
      "nationalities": [
        "AF"
      ],
      "function": "MANAGING_DIRECTOR",
      "soleSignatureAuthorized": true,
      "fatcaControllingPerson": true,
      "deathDay": "2025-08-29",
      "legalRepresentativeId": "123e4567-e89b-12d3-a456-426614174000",
      "globalId": "text",
      "status": "ACTIVE",
      "createdOn": "2025-08-29T20:23:48.577Z",
      "modifiedOn": "2025-08-29T20:23:48.577Z"
    }
  ],
  "pagination": {
    "cursor": "text",
    "limit": 1
  }
}

Get Legal Representative

get

Get legal representative

Authorizations
Path parameters
legalRepresentativeIdstring · uuidRequired

Legal Representative ID

Responses
200

OK

application/json
get
GET /entities/legal-representatives/{legalRepresentativeId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "firstName": "text",
  "lastName": "text",
  "birthDay": "2025-08-29",
  "birthPlace": "text",
  "birthCountry": "AF",
  "taxDetails": [
    {
      "taxId": "text",
      "taxResidency": "AF",
      "noTinConfirmation": false
    }
  ],
  "isUsNationality": true,
  "mainAddress": {
    "street": "text",
    "streetNumber": "text",
    "city": "text",
    "zip": "text",
    "country": "AF",
    "additionalInfo": "text"
  },
  "nationalities": [
    "AF"
  ],
  "function": "MANAGING_DIRECTOR",
  "soleSignatureAuthorized": true,
  "fatcaControllingPerson": true,
  "deathDay": "2025-08-29",
  "legalRepresentativeId": "123e4567-e89b-12d3-a456-426614174000",
  "globalId": "text",
  "status": "ACTIVE",
  "createdOn": "2025-08-29T20:23:48.577Z",
  "modifiedOn": "2025-08-29T20:23:48.577Z"
}

Update Legal Representative

patch

Update legal representative

Authorizations
Path parameters
legalRepresentativeIdstring · uuidRequired

Legal Representative ID

Header parameters
Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body
firstNamestring · min: 1 · max: 255Optional

All first names of the person according to the identification document

Pattern: ^\S+( \S+)*$
lastNamestring · min: 1 · max: 255Optional

Natural person last name

birthDaystring · dateOptional
birthPlacestring · min: 1 · max: 255Optional

Location

birthCountrystring · enumOptional

Country code in ISO 3166-1 alpha-2 standard

Possible values:
isUsNationalitybooleanOptional

FATCA - Question whether the customer is subject to US tax liability (nationality or other references due to a green card, registration address, etc.).

functionstring · enumOptionalPossible values:
soleSignatureAuthorizedbooleanOptional

Indication of whether or not the legal representative is authorized to represent the company individually.

fatcaControllingPersonbooleanOptional

Indication of whether this person is a controlling person under FATCA.
TRUE = if fatcaClassification = PASSIVE_NFE

Responses
202

Accepted

patch
PATCH /entities/legal-representatives/{legalRepresentativeId} 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: 438

{
  "firstName": "text",
  "lastName": "text",
  "birthDay": "2025-08-29",
  "birthPlace": "text",
  "birthCountry": "AF",
  "taxDetails": [
    {
      "taxId": "text",
      "taxResidency": "AF",
      "noTinConfirmation": false
    }
  ],
  "isUsNationality": true,
  "mainAddress": {
    "street": "text",
    "streetNumber": "text",
    "city": "text",
    "zip": "text",
    "country": "AF",
    "additionalInfo": "text"
  },
  "nationalities": [
    "AF"
  ],
  "function": "MANAGING_DIRECTOR",
  "soleSignatureAuthorized": true,
  "fatcaControllingPerson": true
}
No content

Delete Legal Representative

delete

Delete legal representative, it will inactivate the legal representative

Authorizations
Path parameters
legalRepresentativeIdstring · uuidRequired

Legal Representative ID

Header parameters
Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Responses
202

Accepted

delete
DELETE /entities/legal-representatives/{legalRepresentativeId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Accept: */*

No content

Last updated