Appropriateness Test

Get Appropriateness Test

get

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

/appropriateness-test/asset-types/{appropriatenessTestAssetType}

Get appropriateness test for a specific asset type. Returns the latest version of the test available in the database.

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

appropriatenessTestAssetTypestring · enumRequired

Asset type for appropriateness test

Possible values:

Query parameters

TradingProfileLanguagestring · enumRequired

Language code in ISO 639-1 two-letter codes

Possible values:

Responses

200

OK

application/json

Appropriateness test with version and questions

appropriatenessTestIdstring · uuidRequired

versionintegerRequired

Version of the test

assetTypestring · enumRequired

Asset type for appropriateness test

Possible values:

createdOnstring · date-timeRequired

400

Bad Request

application/json

404

Not Found

application/json

get

/appropriateness-test/asset-types/{appropriatenessTestAssetType}

HTTPcURLJavaScriptPython

GET /appropriateness-test/asset-types/{appropriatenessTestAssetType}?TradingProfileLanguage=en HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "appropriatenessTestId": "123e4567-e89b-12d3-a456-426614174000",
  "version": 1,
  "assetType": "SECURITY_TOKEN",
  "questions": [
    {
      "questionCode": "text",
      "category": "text",
      "questionText": "text",
      "answers": [
        {
          "answerCode": "text",
          "answerText": "text"
        }
      ]
    }
  ],
  "createdOn": "2026-03-17T20:21:15.020Z"
}

Submit Appropriateness Test Responses

post

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

/entities/natural-persons/{naturalPersonId}/appropriateness-test/asset-types/{appropriatenessTestAssetType}/responses

Submit appropriateness test responses for a specific asset type

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

naturalPersonIdstring · uuidRequired

Natural Person ID

appropriatenessTestAssetTypestring · enumRequired

Asset type for appropriateness test

Possible values:

Header parameters

Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body

application/json

Data for submitting appropriateness test responses

TradingProfileLanguagestring · enumRequired

Language code in ISO 639-1 two-letter codes

Possible values:

versionintegerRequired

Version of the appropriateness test

Responses

202

Accepted

application/json

400

Bad Request

application/json

404

Not Found

application/json

post

/entities/natural-persons/{naturalPersonId}/appropriateness-test/asset-types/{appropriatenessTestAssetType}/responses

HTTPcURLJavaScriptPython

POST /entities/natural-persons/{naturalPersonId}/appropriateness-test/asset-types/{appropriatenessTestAssetType}/responses 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: 101

{
  "TradingProfileLanguage": "en",
  "version": 1,
  "responses": [
    {
      "questionCode": "text",
      "answerCode": "text"
    }
  ]
}

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

Get Appropriateness Test Responses

get

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

/entities/natural-persons/{naturalPersonId}/appropriateness-test/asset-types/{appropriatenessTestAssetType}/responses

Get all appropriateness test responses for a natural person and specific asset type

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

naturalPersonIdstring · uuidRequired

Natural Person ID

appropriatenessTestAssetTypestring · enumRequired

Asset type for appropriateness test

Possible values:

Query parameters

cursorstringOptional

String value used for pagination

limitinteger · min: 1Required

Maximum number of items to return

Default: 20

TradingProfileLanguagestring · enumRequired

Language code in ISO 639-1 two-letter codes

Possible values:

Responses

200

OK

application/json

Paginated list of appropriateness test responses

400

Bad Request

application/json

404

Not Found

application/json

get

/entities/natural-persons/{naturalPersonId}/appropriateness-test/asset-types/{appropriatenessTestAssetType}/responses

HTTPcURLJavaScriptPython

GET /entities/natural-persons/{naturalPersonId}/appropriateness-test/asset-types/{appropriatenessTestAssetType}/responses?limit=20&TradingProfileLanguage=en HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "data": [
    {
      "TradingProfileLanguage": "en",
      "version": 1,
      "responses": [
        {
          "questionCode": "text",
          "answerCode": "text"
        }
      ],
      "appropriatenessTestId": "123e4567-e89b-12d3-a456-426614174000",
      "appropriatenessTestVersion": 1,
      "appropriatenessTestResponseId": "123e4567-e89b-12d3-a456-426614174000",
      "createdOn": "2026-03-17T20:21:15.020Z",
      "modifiedOn": "2026-03-17T20:21:15.020Z",
      "status": "RECEIVED"
    }
  ],
  "pagination": {
    "cursor": "text",
    "limit": 1
  }
}

Get Appropriateness Test Response

get

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

/entities/natural-persons/appropriateness-test/responses/{appropriatenessTestResponseId}

Get all appropriateness test responses for a natural person and specific asset type

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

appropriatenessTestResponseIdstring · uuidRequired

appropriatenessTestResponseId

Responses

200

OK

application/json

Data for submitting appropriateness test responses

TradingProfileLanguagestring · enumRequired

Language code in ISO 639-1 two-letter codes

Possible values:

versionintegerRequired

Version of the appropriateness test

appropriatenessTestIdstring · uuidRequired

Unique identifier of the appropriateness test

appropriatenessTestVersionintegerRequired

Version of the appropriateness test

appropriatenessTestResponseIdstring · uuidRequired

Unique identifier of the appropriateness test response

createdOnstring · date-timeRequired

Date and time when the response was created

modifiedOnstring · date-timeRequired

Date and time when the response was last modified

statusstring · enumRequired

Status of the appropriateness test response

Possible values:

400

Bad Request

application/json

404

Not Found

application/json

get

/entities/natural-persons/appropriateness-test/responses/{appropriatenessTestResponseId}

HTTPcURLJavaScriptPython

GET /entities/natural-persons/appropriateness-test/responses/{appropriatenessTestResponseId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "TradingProfileLanguage": "en",
  "version": 1,
  "responses": [
    {
      "questionCode": "text",
      "answerCode": "text"
    }
  ],
  "appropriatenessTestId": "123e4567-e89b-12d3-a456-426614174000",
  "appropriatenessTestVersion": 1,
  "appropriatenessTestResponseId": "123e4567-e89b-12d3-a456-426614174000",
  "createdOn": "2026-03-17T20:21:15.020Z",
  "modifiedOn": "2026-03-17T20:21:15.020Z",
  "status": "RECEIVED"
}