LogoLogo
  • Home Page
  • Documentation
    • API Overview
    • Partner API Authentication
    • Customer Management
      • Onboarding
    • Partner Webhooks
    • Status Codes for Financial Operations
    • Prices
  • WEBSOCKETS
    • Websocket Prices
      • Prices
      • Schemas
  • API REFERENCE
    • Authorization
      • Schemas
    • User Management
      • Users
      • Schemas
    • Customers
      • General
      • Legal Entities
      • Natural Persons
      • Customer Labels
      • Search Nace Sectors
      • Onboarding Wizard
      • Schemas
    • Documents
      • Documents
      • Schemas
    • Onboardings
      • Onboarding
      • Offboarding
      • Schemas
    • Products
      • Product Definitions & Fees
      • Customer Products
      • Products Changelog
      • Schemas
    • Asset Management
      • Trading
        • Assets
        • Schemas
      • Digital assets
        • Create Order
        • General
        • Assets
        • Schemas
      • Strategy
        • Schemas
    • Transaction History
      • Schemas
    • Transfers
      • Transfers
      • IBAN validator
      • Create Incoming Test Transfer
      • Schemas
    • Partner Documents
      • Schemas
    • Webhooks
      • Schemas
  • PARTNER APIS
    • Partner Webhooks
      • Schemas
Powered by GitBook
On this page
  1. API REFERENCE
  2. Customers

Customer Labels

Last updated 10 days ago

Remove Label And Its Assignment From All Customers

delete

Ready to test

Removes label from all assigned customers.

Authorizations
Path parameters
customerLabelNamestringRequired

customer label name

Responses
202
Accepted
delete
DELETE /customer-labels/{customerLabelName} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
202

Accepted

No content
  • GETGet List of Customer Labels with assigned customers count
  • PATCHUpdate Customer Label
  • DELETERemove Label And Its Assignment From All Customers
  • PATCHAdd Label To All Provided Customers
  • POSTRemove Label From All Provided Customers

Get List of Customer Labels with assigned customers count

get

Ready to test

Get list of customer labels created by partner with assigned customers count

Authorizations
Responses
200
OK
application/json
get
GET /customer-labels HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
200

OK

[
  {
    "label": "text",
    "customersCount": 1
  }
]

Update Customer Label

patch

Ready to test

Update customer label by changing name. All assigned customers will have updated label name.

Authorizations
Path parameters
customerLabelNamestringRequired

customer label name

Body
namestringRequired

name of customer label

Responses
202
Accepted
400
Bad Request
application/json
patch
PATCH /customer-labels/{customerLabelName} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "name": "text"
}
No content

Add Label To All Provided Customers

patch

Ready to test

Update assignment of customer label to all provided customers. If any customer exceeds the maximum number of labels (16), the request will fail and return in response customer ids that exceeded maximum number of labels. If any customer id is not valid, the request will fail and return in response invalid customer ids.

Authorizations
Path parameters
customerLabelNamestringRequired

customer label name

Body
string · uuid[]Optional
Responses
202
Accepted
400
Bad Request
application/json
patch
PATCH /customer-labels/{customerLabelName}/customers HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 40

[
  "123e4567-e89b-12d3-a456-426614174000"
]
No content

Remove Label From All Provided Customers

post

Ready to test

Remove assignment of customer label from all provided customers. If any customer id is not valid, the request will fail and return in response invalid customer ids.

Authorizations
Path parameters
customerLabelNamestringRequired

customer label name

Body
string · uuid[]Optional
Responses
202
Accepted
400
Bad Request
application/json
post
POST /customer-labels/{customerLabelName}/customers HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 40

[
  "123e4567-e89b-12d3-a456-426614174000"
]
No content