Onboardings

Start Onboarding

post

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

/roles/onboardings

Start onboarding process for a role

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Header parameters

Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body

application/json

roleTypestring · enumRequiredPossible values:

roleIdstring · uuidRequired

Identification number in UUID format of the role (customer or proxy)

Responses

200

OK

application/json

400

Bad Request

application/json

404

Not Found

application/json

409

Conflict

application/json

post

/roles/onboardings

HTTPcURLJavaScriptPython

POST /roles/onboardings 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: 71

{
  "roleType": "CUSTOMER",
  "roleId": "123e4567-e89b-12d3-a456-426614174000"
}

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

Get Onboardings

get

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

/roles/onboardings

Get list of onboardings for a role

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Query parameters

onboardingRoleTypestring · enumRequired

Type of role for onboarding

Possible values:

roleIdstring · uuidRequired

Unique identification number of role (customer or proxy) in UUID format.

Responses

200

OK

application/json

404

Not Found

application/json

get

/roles/onboardings

HTTPcURLJavaScriptPython

GET /roles/onboardings?onboardingRoleType=CUSTOMER&roleId=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "onboardingId": "123e4567-e89b-12d3-a456-426614174000",
    "status": "CREATED",
    "roleType": "CUSTOMER",
    "roleId": "123e4567-e89b-12d3-a456-426614174000",
    "createdOn": "2026-01-31T11:59:48.081Z",
    "modifiedOn": "2026-01-31T11:59:48.081Z"
  }
]

Get Onboarding

get

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

/roles/onboardings/{onboardingId}

Get onboarding information

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

onboardingIdstring · uuidRequired

Unique onboarding identification number in UUID format

Responses

200

OK

application/json

404

Not Found

application/json

get

/roles/onboardings/{onboardingId}

HTTPcURLJavaScriptPython

GET /roles/onboardings/{onboardingId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "onboardingId": "123e4567-e89b-12d3-a456-426614174000",
  "status": "CREATED",
  "roleType": "CUSTOMER",
  "roleId": "123e4567-e89b-12d3-a456-426614174000",
  "createdOn": "2026-01-31T11:59:48.081Z",
  "modifiedOn": "2026-01-31T11:59:48.081Z"
}