Customer Products

Get Customer Products

get

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

/customers/{customerId}/products

Get Customer Products

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

customerIdstring · uuidRequired

Customer ID

Query parameters

productTypestring · enumOptional

Product type

Possible values:

productCodestring · enumOptional

Product code

Possible values:

statusstring · enumOptional

The status of the account

Possible values:

ibanstringOptional

The IBAN of a cash account

Responses

200

OK

application/json

customerProductIdstring · uuidRequired

The ID of the product instance for the given customer

productCodestring · enumRequired

Product code

Possible values:

productTypestring · enumRequired

Product type

Possible values:

currencystring · enumOptional

Currency of the product's balance. Currency code in ISO 4217

Possible values:

statusstring · enumRequiredPossible values:

proxyIdsstring · uuid[]Optional

createdOnstring · date-timeRead-onlyRequired

modifiedOnstring · date-timeRead-onlyRequired

openedOnstring · date-timeRead-onlyOptional

closedOnstring · date-timeRead-onlyOptional

400

Bad Request

application/json

get

/customers/{customerId}/products

HTTPcURLJavaScriptPython

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

[
  {
    "customerProductId": "123e4567-e89b-12d3-a456-426614174000",
    "productCode": "WALLET",
    "productType": "CASH",
    "currency": "EUR",
    "accountData": {
      "iban": "text",
      "bic": "text",
      "availableBalance": 1,
      "withdrawableBalance": 1,
      "modifiedOn": "2026-03-04T01:18:08.473Z"
    },
    "cryptoAssets": [
      {
        "cryptoSymbol": "text",
        "quantity": 1,
        "availableQuantity": 1,
        "avgBuyPrice": 1,
        "modifiedOn": "2026-03-04T01:18:08.473Z"
      }
    ],
    "traditionalAssets": [
      {
        "isin": "text",
        "quantity": 1,
        "availableQuantity": 1,
        "avgBuyPrice": 1,
        "modifiedOn": "2026-03-04T01:18:08.473Z"
      }
    ],
    "status": "RECEIVED",
    "proxyIds": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "createdOn": "2026-03-04T01:18:08.473Z",
    "modifiedOn": "2026-03-04T01:18:08.473Z",
    "openedOn": "2026-03-04T01:18:08.473Z",
    "closedOn": "2026-03-04T01:18:08.473Z"
  }
]

Create Customer Product

post

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

/customers/{customerId}/products

Create Customer Product

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

customerIdstring · uuidRequired

customer ID the partner is creating a product for

Header parameters

Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body

application/json

productCodestring · enumRequired

Product code

Possible values:

Responses

200

OK

application/json

customerProductIdstring · uuidRequired

400

Bad Request

application/json

post

/customers/{customerId}/products

HTTPcURLJavaScriptPython

POST /customers/{customerId}/products 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: 24

{
  "productCode": "WALLET"
}

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

Get Customer Product

get

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

/products/{customerProductId}

Get Customer Product

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

customerProductIdstring · uuidRequired

the ID of the product instance for the given customer

Responses

200

OK

application/json

customerProductIdstring · uuidRequired

The ID of the product instance for the given customer

productCodestring · enumRequired

Product code

Possible values:

productTypestring · enumRequired

Product type

Possible values:

currencystring · enumOptional

Currency of the product's balance. Currency code in ISO 4217

Possible values:

statusstring · enumRequiredPossible values:

proxyIdsstring · uuid[]Optional

createdOnstring · date-timeRead-onlyRequired

modifiedOnstring · date-timeRead-onlyRequired

openedOnstring · date-timeRead-onlyOptional

closedOnstring · date-timeRead-onlyOptional

400

Bad Request

application/json

404

Not Found

application/json

get

/products/{customerProductId}

HTTPcURLJavaScriptPython

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

{
  "customerProductId": "123e4567-e89b-12d3-a456-426614174000",
  "productCode": "WALLET",
  "productType": "CASH",
  "currency": "EUR",
  "accountData": {
    "iban": "text",
    "bic": "text",
    "availableBalance": 1,
    "withdrawableBalance": 1,
    "modifiedOn": "2026-03-04T01:18:08.473Z"
  },
  "cryptoAssets": [
    {
      "cryptoSymbol": "text",
      "quantity": 1,
      "availableQuantity": 1,
      "avgBuyPrice": 1,
      "modifiedOn": "2026-03-04T01:18:08.473Z"
    }
  ],
  "traditionalAssets": [
    {
      "isin": "text",
      "quantity": 1,
      "availableQuantity": 1,
      "avgBuyPrice": 1,
      "modifiedOn": "2026-03-04T01:18:08.473Z"
    }
  ],
  "status": "RECEIVED",
  "proxyIds": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "createdOn": "2026-03-04T01:18:08.473Z",
  "modifiedOn": "2026-03-04T01:18:08.473Z",
  "openedOn": "2026-03-04T01:18:08.473Z",
  "closedOn": "2026-03-04T01:18:08.473Z"
}

Update customer product

patch

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

/products/{customerProductId}

Update customer product. It is used to close the customer product.

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

customerProductIdstring · uuidRequired

the ID of the product instance for the given customer

Header parameters

Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body

application/json

statusstring · enumRequiredPossible values:

Responses

200

OK

No content

400

Bad Request

application/json

404

Not Found

application/json

patch

/products/{customerProductId}

HTTPcURLJavaScriptPython

PATCH /products/{customerProductId} 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: 19

{
  "status": "CLOSED"
}

No content