Users

Create User

post

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

/users

Create a user. Provided email needs to be unique.

Data provided will be used to create credentials to access Partner Panel. Specifically, provided email will be used to identify created account. This means that email needs to be unique.

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Body

application/json

genderstring · enumRequired

Gender

Possible values:

firstNamestring · max: 255Required

All first names of the person according to the identification document

Pattern: ^\S+( \S+)*$

lastNamestring · max: 255Required

birthDaystring · dateRequired

birthPlacestring · max: 255Required

birthCountrystring · enumRequired

Country code in ISO 3166-1 alpha-2 standard

Possible values:

typestring · enumRequiredPossible values:

Responses

200

OK

application/json

userIdstring · uuidRead-onlyRequired

Unique user identification number in UUID format

400

Bad Request

application/json

post

/users

HTTPcURLJavaScriptPython

POST /users HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 363

{
  "gender": "MALE",
  "firstName": "text",
  "lastName": "text",
  "birthDay": "2026-03-03",
  "birthPlace": "text",
  "birthCountry": "AF",
  "nationalities": [
    "AF"
  ],
  "mainAddress": {
    "street": "text",
    "streetNumber": "text",
    "city": "text",
    "zip": "text",
    "state": "text",
    "country": "AF",
    "additionalInfo": "text"
  },
  "contact": {
    "phone": "text",
    "email": "text",
    "fax": "text",
    "website": "text"
  },
  "type": "ADMIN"
}

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

Get Users

get

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

/users

Get list of users

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Query parameters

cursorstringOptional

String value used for pagination

limitinteger · min: 1Required

Maximum number of items to return

Default: 20

userTypestring · enumOptional

User type filter

Possible values:

userStatusstring · enumRead-onlyOptional

Current customer status

Possible values:

firstNamestringOptional

String value used for firstName

lasttNamestringOptional

String value used for lastName

emailstringOptional

String value used for email

userIdstringOptional

Uuid value used for userId

globalIdstringOptional

String value used for globalId

Responses

200

OK

application/json

400

Bad Request

application/json

get

/users

HTTPcURLJavaScriptPython

GET /users?limit=20 HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "data": [
    {
      "userId": "123e4567-e89b-12d3-a456-426614174000",
      "globalId": "text",
      "status": "RECEIVED",
      "createdOn": "2026-03-03T02:04:30.495Z",
      "modifiedOn": "2026-03-03T02:04:30.495Z",
      "gender": "MALE",
      "firstName": "text",
      "lastName": "text",
      "birthDay": "2026-03-03",
      "birthPlace": "text",
      "birthCountry": "AF",
      "nationalities": [
        "AF"
      ],
      "mainAddress": {
        "street": "text",
        "streetNumber": "text",
        "city": "text",
        "zip": "text",
        "state": "text",
        "country": "AF",
        "additionalInfo": "text"
      },
      "contact": {
        "phone": "text",
        "email": "text",
        "fax": "text",
        "website": "text"
      },
      "type": "ADMIN"
    }
  ],
  "pagination": {
    "cursor": "text",
    "limit": 1
  }
}

Get User

get

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

/users/{userId}

Get user

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

userIdstring · uuidRequired

User ID

Responses

200

OK

application/json

mfaTypestring · enumRequiredPossible values:

userIdstring · uuidRead-onlyRequired

Unique identification number in UUID format

globalIdstring · min: 12 · max: 12Required

Global ID of the user

statusstring · enumRead-onlyRequired

Current customer status

Possible values:

createdOnstring · date-timeRead-onlyRequired

The date of creation

modifiedOnstring · date-timeRead-onlyRequired

The date of last modification

genderstring · enumRequired

Gender

Possible values:

firstNamestring · max: 255Required

All first names of the person according to the identification document

Pattern: ^\S+( \S+)*$

lastNamestring · max: 255Required

birthDaystring · dateRequired

birthPlacestring · max: 255Required

birthCountrystring · enumRequired

Country code in ISO 3166-1 alpha-2 standard

Possible values:

typestring · enumRequiredPossible values:

400

Bad Request

application/json

404

Not Found

application/json

get

/users/{userId}

HTTPcURLJavaScriptPython

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

{
  "mfaType": "SMS",
  "userId": "123e4567-e89b-12d3-a456-426614174000",
  "globalId": "text",
  "status": "RECEIVED",
  "createdOn": "2026-03-03T02:04:30.495Z",
  "modifiedOn": "2026-03-03T02:04:30.495Z",
  "gender": "MALE",
  "firstName": "text",
  "lastName": "text",
  "birthDay": "2026-03-03",
  "birthPlace": "text",
  "birthCountry": "AF",
  "nationalities": [
    "AF"
  ],
  "mainAddress": {
    "street": "text",
    "streetNumber": "text",
    "city": "text",
    "zip": "text",
    "state": "text",
    "country": "AF",
    "additionalInfo": "text"
  },
  "contact": {
    "phone": "text",
    "email": "text",
    "fax": "text",
    "website": "text"
  },
  "type": "ADMIN"
}

Update User

patch

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

/users/{userId}

Update user

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

userIdstring · uuidRequired

User ID

Body

application/json

lastNamestring · max: 255Optional

statusstring · enumOptional

Update to INACTIVE or SUSPENDED is possible only from ACTIVE status. It will disable user access to API. Update to ACTIVE is possible only from SUSPENDED. It will enable user access to API.

Possible values:

mfaTypestring · enumOptional

Sending request with SMS will switch MFA to SMS until the next time user login. After that method will be switched to TOTP again.

Possible values:

Responses

200

OK

No content

400

Bad Request

application/json

patch

/users/{userId}

HTTPcURLJavaScriptPython

PATCH /users/{userId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 270

{
  "lastName": "text",
  "nationalities": [
    "AF"
  ],
  "mainAddress": {
    "street": "text",
    "streetNumber": "text",
    "city": "text",
    "zip": "text",
    "state": "text",
    "country": "AF",
    "additionalInfo": "text"
  },
  "contact": {
    "phone": "text",
    "fax": "text",
    "website": "text"
  },
  "status": "INACTIVE",
  "mfaType": "SMS"
}

No content