Legal Representatives

Create Legal Representative

post

https://tvda-api.platform-test.tradevest.aihttps://tvda-api.platform-pretest.tradevest.ai

/entities/{legalEntityId}/legal-representatives

Create new legal representative

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

legalEntityIdstring · uuidRequired

Legal Entity ID

Body

application/json

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

400

Bad Request

application/json

409

Conflict

application/json

post

/entities/{legalEntityId}/legal-representatives

HTTPcURLJavaScriptPython

POST /entities/{legalEntityId}/legal-representatives HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 453

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

{
  "legalRepresentativeId": "123e4567-e89b-12d3-a456-426614174000"
}

Get Legal Representatives

get

https://tvda-api.platform-test.tradevest.aihttps://tvda-api.platform-pretest.tradevest.ai

/entities/{legalEntityId}/legal-representatives

Get legal representatives

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

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

400

Bad Request

application/json

get

/entities/{legalEntityId}/legal-representatives

HTTPcURLJavaScriptPython

GET /entities/{legalEntityId}/legal-representatives?limit=20 HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

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

Get Legal Representative

get

https://tvda-api.platform-test.tradevest.aihttps://tvda-api.platform-pretest.tradevest.ai

/entities/legal-representatives/{legalRepresentativeId}

Get legal representative

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

legalRepresentativeIdstring · uuidRequired

Legal Representative ID

Responses

200

OK

application/json

400

Bad Request

application/json

404

Not Found

application/json

get

/entities/legal-representatives/{legalRepresentativeId}

HTTPcURLJavaScriptPython

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-12-14",
  "birthPlace": "text",
  "birthCountry": "AF",
  "taxDetails": [
    {
      "taxId": "text",
      "taxResidency": "AF",
      "noTinConfirmation": false
    }
  ],
  "isUsNationality": true,
  "mainAddress": {
    "street": "text",
    "streetNumber": "text",
    "city": "text",
    "zip": "text",
    "state": "text",
    "country": "AF",
    "additionalInfo": "text"
  },
  "nationalities": [
    "AF"
  ],
  "function": "MANAGING_DIRECTOR",
  "soleSignatureAuthorized": true,
  "fatcaControllingPerson": true,
  "deathDay": "2025-12-14",
  "legalRepresentativeId": "123e4567-e89b-12d3-a456-426614174000",
  "globalId": "text",
  "status": "ACTIVE",
  "createdOn": "2025-12-14T10:14:50.556Z",
  "modifiedOn": "2025-12-14T10:14:50.556Z"
}

Update Legal Representative

patch

https://tvda-api.platform-test.tradevest.aihttps://tvda-api.platform-pretest.tradevest.ai

/entities/legal-representatives/{legalRepresentativeId}

Update legal representative

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

legalRepresentativeIdstring · uuidRequired

Legal Representative ID

Header parameters

Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body

application/json

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

400

Bad Request

application/json

patch

/entities/legal-representatives/{legalRepresentativeId}

HTTPcURLJavaScriptPython

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: 453

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

No content

Delete Legal Representative

delete

https://tvda-api.platform-test.tradevest.aihttps://tvda-api.platform-pretest.tradevest.ai

/entities/legal-representatives/{legalRepresentativeId}

Delete legal representative, it will inactivate the legal representative

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

legalRepresentativeIdstring · uuidRequired

Legal Representative ID

Header parameters

Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Responses

202

Accepted

400

Bad Request

application/json

delete

/entities/legal-representatives/{legalRepresentativeId}

HTTPcURLJavaScriptPython

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