Documents v2

Get Documents

get

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

/v2/documents

Get documents. By default, it returns last 20 documents. It is possible to send query parameters to adjust the result

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Query parameters

startDatestring · date-timeOptional

Beginning of the range

endDatestring · date-timeOptional

End of the range

searchTextstringOptional

search string to filter through document names

resourceTypestring · enumRequiredPossible values:

resourceIdstring · uuidRequired

docTypestring · enumOptional

This list may change in the future.

Possible values:

cursorstringOptional

String value used for pagination

limitinteger · min: 1Required

Maximum number of items to return

Default: 20

Responses

200

OK

application/json

404

Not Found

application/json

get

/v2/documents

HTTPcURLJavaScriptPython

GET /v2/documents?resourceType=NATURAL_PERSON&resourceId=123e4567-e89b-12d3-a456-426614174000&limit=20 HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "data": [
    {
      "documentId": "123e4567-e89b-12d3-a456-426614174000",
      "size": 1,
      "status": "RECEIVED",
      "validUntil": "2026-03-18T07:20:19.809Z",
      "createdOn": "2026-03-18T07:20:19.809Z",
      "modifiedOn": "2026-03-18T07:20:19.809Z",
      "name": "text",
      "resourceType": "NATURAL_PERSON",
      "type": "KYC",
      "description": "text",
      "resourceId": "123e4567-e89b-12d3-a456-426614174000",
      "externalId": "text"
    }
  ],
  "pagination": {
    "cursor": "text",
    "limit": 1
  }
}

Upload Document

post

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

/v2/documents

Document Group	Document Type	Entities/Roles
Company documents	CURRENT_REGISTRY_EXTRACT CHRONOLOGICAL_REGISTRY_EXTRACT SHAREHOLDER_LIST PARTNERSHIP_AGREEMENT TRANSPARENCY_REGISTER_EXTRACT STATUTE	LEGAL_ENTITY
Company documents	BUSINESS_REGISTRATION	NATURAL_PERSON LEGAL_ENTITY
Kyc documents	IDENTIFICATION_CERTIFICATE PROOF_OF_RESIDENCE KYC	NATURAL_PERSON PARTNER_USER
Kyc documents	BIRTH_CERTIFICATE	NATURAL_PERSON (Minor)
Kyc documents	DEATH_CERTIFICATE	NATURAL_PERSON
Tax documents	TIN_NA_CONFIRMATION	NATURAL_PERSON
Tax documents	W_8BEN_E	LEGAL_ENTITY
Financial situation documents	SOURCE_OF_INCOME SOURCE_OF_FUNDS	CUSTOMER
Proxy documents	PROOF_OF_SINGLE_CUSTODY PROOF_OF_CUSTODY	PROXY (Guardian)
Proxy documents	INSOLVENCY_ORDER	PROXY (Liquidator)
Proxy documents	INHERITANCE_LIGITIMATION	PROXY (Power of Attorney in case of death)
General documents	OTHER	NATURAL_PERSON JOINT_PERSON LEGAL_ENTITY PARTNER_USER CUSTOMER PROXY

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Header parameters

Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body

multipart/form-data

filestring · binaryRequired

File data

Responses

200

OK

application/json

documentIdstring · uuidRead-onlyRequired

400

Bad Request

application/json

409

Conflict

application/json

post

/v2/documents

HTTPcURLJavaScriptPython

POST /v2/documents HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: multipart/form-data
Accept: */*
Content-Length: 182

{
  "document": {
    "name": "text",
    "resourceType": "NATURAL_PERSON",
    "type": "KYC",
    "description": "text",
    "resourceId": "123e4567-e89b-12d3-a456-426614174000",
    "externalId": "text"
  },
  "file": "binary"
}

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

Get Document

get

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

/v2/documents/{documentId}

Get document

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

documentIdstring · uuidRequired

Unique document identification number in UUID format

Responses

200

OK

application/json

documentIdstring · uuidRead-onlyRequired

sizeintegerRead-onlyRequired

file size in kB

statusstring · enumRead-onlyRequiredPossible values:

validUntilstring · date-timeRead-onlyOptional

createdOnstring · date-timeRead-onlyRequired

modifiedOnstring · date-timeRead-onlyRequired

namestring · min: 1 · max: 255Required

resourceTypestring · enumRequiredPossible values:

typestring · enumRequired

This list may change in the future.

Possible values:

descriptionstring · min: 1 · max: 255Optional

resourceIdstring · uuidRequired

Identification number in UUID format of resource of type identified by the value of resourceType field

externalIdstring · min: 1Optional

External Id in partner's system. This value has to be unique

404

Not Found

application/json

get

/v2/documents/{documentId}

HTTPcURLJavaScriptPython

GET /v2/documents/{documentId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "documentId": "123e4567-e89b-12d3-a456-426614174000",
  "size": 1,
  "status": "RECEIVED",
  "validUntil": "2026-03-18T07:20:19.809Z",
  "createdOn": "2026-03-18T07:20:19.809Z",
  "modifiedOn": "2026-03-18T07:20:19.809Z",
  "name": "text",
  "resourceType": "NATURAL_PERSON",
  "type": "KYC",
  "description": "text",
  "resourceId": "123e4567-e89b-12d3-a456-426614174000",
  "externalId": "text"
}

Get Document File

get

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

/v2/documents/{documentId}/file

Get document file

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

documentIdstring · uuidRequired

Unique document identification number in UUID format

Responses

200

OK

application/octet-stream

string · binaryOptional

404

Not Found

application/json

get

/v2/documents/{documentId}/file

HTTPcURLJavaScriptPython

GET /v2/documents/{documentId}/file HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

binary

Sign Document

post

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

/v2/documents/sign

Create new natural person document signature

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Header parameters

Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body

application/json

partnerDocumentIdstring · uuidRequired

Id of the partner document which was signed

naturalPersonIdstring · uuidRequired

Id of the natural person for which the document is signed

customerIdstring · uuidOptional

Id of the customer in whose context the natural person is active. Required only for TERMS_AND_CONDITIONS document type.

Responses

202

Accepted

400

Bad Request

application/json

post

/v2/documents/sign

HTTPcURLJavaScriptPython

POST /v2/documents/sign 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: 169

{
  "partnerDocumentId": "123e4567-e89b-12d3-a456-426614174000",
  "naturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
  "customerId": "123e4567-e89b-12d3-a456-426614174000"
}

No content