Partner Webhooks | Tradevest

Customer Notification

post

Notification about customer changes related to event CUSTOMER_NOTIFICATION

Body

customerIdstring · uuidRequired

modifiedOnstring · date-timeOptional

statusstring · enumOptionalPossible values:

notificationTypestring · enumRequiredPossible values:

Responses

200

OK

No content

400

Bad Request

application/json

post

/customer-notification

POST /customer-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 217

{
  "customerId": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedOn": "2026-01-31T17:44:01.064Z",
  "status": "CREATED",
  "notificationType": "CREATED",
  "validationError": {
    "errorType": "ALREADY_EXISTS_ERROR",
    "description": "text"
  }
}

No content

Legal Entity Notification

post

Notification about legal entity changes related to event LEGAL_ENTITY_NOTIFICATION

Body

legalEntityIdstring · uuidRequired

modifiedOnstring · date-timeOptional

statusstring · enumOptionalPossible values:

notificationTypestring · enumRequiredPossible values:

Responses

200

OK

No content

post

/legal-entity-notification

POST /legal-entity-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 220

{
  "legalEntityId": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedOn": "2026-01-31T17:44:01.064Z",
  "status": "CREATED",
  "notificationType": "CREATED",
  "validationError": {
    "errorType": "ALREADY_EXISTS_ERROR",
    "description": "text"
  }
}

200

OK

No content

Legal Representative Notification

post

Notification about legal representative changes related to event LEGAL_REPRESENTATIVE_NOTIFICATION

Body

legalRepresentativeIdstring · uuidRequired

modifiedOnstring · date-timeOptional

statusstring · enumOptionalPossible values:

notificationTypestring · enumRequiredPossible values:

Responses

200

OK

No content

post

/legal-representative-notification

POST /legal-representative-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 227

{
  "legalRepresentativeId": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedOn": "2026-01-31T17:44:01.064Z",
  "status": "ACTIVE",
  "notificationType": "CREATED",
  "validationError": {
    "errorType": "ALREADY_EXISTS_ERROR",
    "description": "text"
  }
}

200

OK

No content

Corporate Action Notification

post

Notification about corporate action update related to event CORPORATE_ACTION_NOTIFICATION

Body

typestring · enumRequired

Corporate action notification type

Possible values:

eventIdstring · uuidRequired

caevstring · enumRequired

Corporate action event type

Possible values:

isinstringRequired

statusstring · enumRequired

Corporate action event status

Possible values:

Responses

200

OK

post

/corporate-action-notification

POST /corporate-action-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 572

{
  "type": "CREATED",
  "eventId": "123e4567-e89b-12d3-a456-426614174000",
  "caev": "DVCA",
  "isin": "text",
  "status": "ANNOUNCED",
  "dates": {
    "exDate": "2026-01-31",
    "payDate": "2026-01-31",
    "effectiveDate": "2026-01-31"
  },
  "details": {
    "bonusRatio": 1,
    "grossAmountPerShare": 1,
    "splitRatio": 1
  },
  "accounts": [
    {
      "customerProductId": "123e4567-e89b-12d3-a456-426614174000",
      "oldQuantity": 1,
      "newQuantity": 1,
      "splitRatio": 1,
      "grossAmount": 1,
      "netAmount": 1,
      "currency": "EUR"
    }
  ],
  "metadata": {
    "summary": "text"
  },
  "validationError": {
    "errorType": "CUSTOMER_PRODUCT_NOT_SUBJECTABLE_TO_CORPORATE_ACTION",
    "description": "text"
  }
}

200

OK

No content

Natural Person Notification

post

Notification about natural person changes related to event NATURAL_PERSON_NOTIFICATION

Body

naturalPersonIdstring · uuidRequired

modifiedOnstring · date-timeOptional

statusstring · enumOptionalPossible values:

notificationTypestring · enumRequiredPossible values:

Responses

200

OK

No content

post

/natural-person-notification

POST /natural-person-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 222

{
  "naturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedOn": "2026-01-31T17:44:01.064Z",
  "status": "CREATED",
  "notificationType": "CREATED",
  "validationError": {
    "errorType": "ALREADY_EXISTS_ERROR",
    "description": "text"
  }
}

200

OK

No content

Joint Person Notification

post

Notification about joint person changes related to event JOINT_PERSON_NOTIFICATION

Body

jointPersonIdstring · uuidRequired

modifiedOnstring · date-timeOptional

statusstring · enumOptionalPossible values:

notificationTypestring · enumRequiredPossible values:

Responses

200

OK

No content

post

/joint-person-notification

POST /joint-person-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 220

{
  "jointPersonId": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedOn": "2026-01-31T17:44:01.064Z",
  "status": "CREATED",
  "notificationType": "CREATED",
  "validationError": {
    "errorType": "ALREADY_EXISTS_ERROR",
    "description": "text"
  }
}

200

OK

No content

Identification Verification Notification

post

Notification about identification verification changes related to event IDENTIFICATION_VERIFICATION_NOTIFICATION

Body

identificationVerificationIdstring · uuidRequired

naturalPersonIdstring · uuidRequired

modifiedOnstring · date-timeRequired

statusstring · enumRequiredPossible values:

notificationTypestring · enumRequiredPossible values:

Responses

200

OK

No content

post

/identification-verification-notification

POST /identification-verification-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 293

{
  "identificationVerificationId": "123e4567-e89b-12d3-a456-426614174000",
  "naturalPersonId": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedOn": "2026-01-31T17:44:01.064Z",
  "status": "RECEIVED",
  "notificationType": "CREATED",
  "validationError": {
    "errorType": "ALREADY_EXISTS_ERROR",
    "description": "text"
  }
}

200

OK

No content

Labels Update Notification

post

Notification about labels updates related to event LABELS_UPDATE_NOTIFICATION

Body

updatedCustomersstring · uuid[]Optional

notificationTypestring · enumRequiredPossible values:

Responses

200

OK

No content

post

/labels-update-notification

POST /labels-update-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 171

{
  "updatedCustomers": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "notificationType": "CREATED",
  "validationError": {
    "errorType": "CUSTOMERS_NOT_FOUND_ERROR",
    "description": "text"
  }
}

200

OK

No content

Onboarding Notification

post

Notification about onboarding update related to event ONBOARDING_NOTIFICATION

Body

onboardingIdstring · uuidRequired

modifiedOnstring · date-timeRequired

statusstring · enumRequiredPossible values:

notificationTypestring · enumRequiredPossible values:

Responses

200

OK

post

/onboarding-notification

POST /onboarding-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 230

{
  "onboardingId": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedOn": "2026-01-31T17:44:01.064Z",
  "status": "CREATED",
  "notificationType": "STARTED",
  "validationErrors": [
    {
      "errorType": "CUSTOMER_STATUS_VERIFICATION",
      "description": "text"
    }
  ]
}

200

OK

No content

Proxy Notification

post

Notification about proxy update related to event PROXY_NOTIFICATION

Body

proxyIdstring · uuidRequired

modifiedOnstring · date-timeOptional

statusstring · enumOptionalPossible values:

notificationTypestring · enumRequiredPossible values:

Responses

200

OK

post

/proxy-notification

POST /proxy-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 214

{
  "proxyId": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedOn": "2026-01-31T17:44:01.064Z",
  "status": "CREATED",
  "notificationType": "CREATED",
  "validationError": {
    "errorType": "ALREADY_EXISTS_ERROR",
    "description": "text"
  }
}

200

OK

No content

Beneficial Owner Notification

post

Notification about beneficial owner update related to event BENEFICIAL_OWNER_NOTIFICATION

Body

beneficialOwnerIdstring · uuidRequired

modifiedOnstring · date-timeOptional

statusstring · enumOptionalPossible values:

notificationTypestring · enumRequiredPossible values:

Responses

200

OK

post

/beneficial-owner-notification

POST /beneficial-owner-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 224

{
  "beneficialOwnerId": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedOn": "2026-01-31T17:44:01.064Z",
  "status": "CREATED",
  "notificationType": "CREATED",
  "validationError": {
    "errorType": "ALREADY_EXISTS_ERROR",
    "description": "text"
  }
}

200

OK

No content

Partner Document Notification

post

Notification about partner document update related to event PARTNER_DOCUMENT_NOTIFICATION

Body

documentIdstring · uuidRequired

modifiedOnstring · date-timeRequired

Responses

200

OK

No content

post

/partner-document-notification

POST /partner-document-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 93

{
  "documentId": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedOn": "2026-01-31T17:44:01.064Z"
}

200

OK

No content

Document Notification

post

Notification about document update related to event DOCUMENT_NOTIFICATION

Body

documentIdstring · uuidRequired

modifiedOnstring · date-timeRequired

statusstring · enumRequiredPossible values:

notificationTypestring · enumRequiredPossible values:

Responses

200

OK

No content

post

/document-notification

POST /document-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 211

{
  "documentId": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedOn": "2026-01-31T17:44:01.064Z",
  "status": "RECEIVED",
  "notificationType": "CREATED",
  "validationError": {
    "errorType": "UNKNOWN_ERROR",
    "description": "text"
  }
}

200

OK

No content

Customer Product Notification

post

Notifications about customer product update related to event CUSTOMER_PRODUCT_NOTIFICATION

Body

customerIdstring · uuidRequired

customerProductIdstring · uuidRequired

modifiedOnstring · date-timeOptional

statusstring · enumOptionalPossible values:

notificationTypestring · enumRequiredPossible values:

Responses

200

OK

No content

post

/customer-product-notification

POST /customer-product-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 274

{
  "customerId": "123e4567-e89b-12d3-a456-426614174000",
  "customerProductId": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedOn": "2026-01-31T17:44:01.064Z",
  "status": "PENDING",
  "notificationType": "CREATED",
  "validationError": {
    "errorType": "PRODUCT_NOT_ACTIVE",
    "description": "text"
  }
}

200

OK

No content

Legal Entity Search Notification

post

Notification about legal entity search changes related to event LEGAL_ENTITY_SEARCH_NOTIFICATION

Body

searchIdstring · uuidRequired

modifiedOnstring · date-timeRequired

statusstring · enumRequired

status of the search

Possible values:

Responses

200

OK

No content

post

/legal-entity-search-notification

POST /legal-entity-search-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 119

{
  "searchId": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedOn": "2026-01-31T17:44:01.064Z",
  "status": "WAITING_FOR_DATA"
}

200

OK

No content

Strategy Notification

post

Notification about strategy update related to event STRATEGY_NOTIFICATION

Body

strategyIdstring · uuidRequired

subscriberIdstring · uuidOptional

modifiedOnstring · date-timeOptional

statusstring · enumOptionalPossible values:

notificationTypestring · enumRequiredPossible values:

Responses

200

OK

post

/strategy-notification

POST /strategy-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 273

{
  "strategyId": "123e4567-e89b-12d3-a456-426614174000",
  "subscriberId": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedOn": "2026-01-31T17:44:01.064Z",
  "status": "EXECUTING",
  "notificationType": "CREATED",
  "validationError": {
    "errorType": "ALREADY_EXISTS_ERROR",
    "description": "text"
  }
}

200

OK

No content

Transfer Notification

post

Notification about transfer update related to event TRANSFER_NOTIFICATION

Body

customerIdstring · uuidRequired

customerProductIdstring · uuidRequired

transferIdstring · uuidRequired

modifiedOnstring · date-timeOptional

statusstring · enumOptionalPossible values:

notificationTypestring · enumRequiredPossible values:

Responses

200

OK

post

/transfer-notification

POST /transfer-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 329

{
  "customerId": "123e4567-e89b-12d3-a456-426614174000",
  "customerProductId": "123e4567-e89b-12d3-a456-426614174000",
  "transferId": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedOn": "2026-01-31T17:44:01.064Z",
  "status": "RECEIVED",
  "notificationType": "CREATED",
  "validationError": {
    "errorType": "INSUFFICIENT_BALANCE",
    "description": "text"
  }
}

200

OK

No content

Digital Asset Order Notification

post

Notification about digital asset order update related to event DIGITAL_ASSET_ORDER_NOTIFICATION

Body

orderIdstring · uuidRequired

customerProductIdstring · uuidRequired

externalIdstringRequired

statusstring · enumRequiredPossible values:

notificationTypestring · enumRequiredPossible values:

Responses

200

OK

post

/digital-asset-order-notification

POST /digital-asset-order-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 320

{
  "orderId": "123e4567-e89b-12d3-a456-426614174000",
  "customerProductId": "123e4567-e89b-12d3-a456-426614174000",
  "externalId": "text",
  "status": "RECEIVED",
  "notificationType": "CREATED",
  "validationError": {
    "errorType": "ASSET_NOT_ACTIVE",
    "description": "text"
  },
  "executionData": {
    "quantity": 1,
    "executionPrice": 1,
    "executionAmount": 1
  }
}

200

OK

No content

Traditional Asset Order Notification

post

Notification about traditional asset order update related to event TRADITIONAL_ASSET_ORDER_NOTIFICATION

Body

orderIdstring · uuidRequired

customerProductIdstring · uuidRequired

externalIdstringRequired

exAnteIdstring · uuidOptional

The ex ante id is returned for RECEIVED orders

executionIdstring · uuidOptional

The trade execution id is returned for FILLED and PARTIALLY_FILLED orders

statusstring · enumRequiredPossible values:

notificationTypestring · enumRequiredPossible values:

Responses

200

OK

post

/traditional-asset-order-notification

POST /traditional-asset-order-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 520

{
  "orderId": "123e4567-e89b-12d3-a456-426614174000",
  "customerProductId": "123e4567-e89b-12d3-a456-426614174000",
  "externalId": "text",
  "exAnteId": "123e4567-e89b-12d3-a456-426614174000",
  "executionId": "123e4567-e89b-12d3-a456-426614174000",
  "status": "RECEIVED",
  "notificationType": "CREATED",
  "validationError": {
    "errorType": "INSUFFICIENT_BALANCE",
    "description": "text"
  },
  "executionData": {
    "quantity": 1,
    "executionPrice": 1,
    "executionAmount": 1,
    "germanCit": 1,
    "solidaritySurcharge": 1,
    "churchTax": 1,
    "feeAmount": 1.01,
    "feeDescription": "text"
  }
}

200

OK

No content

User Notification

post

Notification related to event USER_NOTIFICATION

Body

userIdstringRequired

modifiedOnstring · date-timeOptional

statusstring · enumOptionalPossible values:

notificationTypestring · enumRequiredPossible values:

Responses

200

OK

post

/user-notification

POST /user-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 182

{
  "userId": "text",
  "modifiedOn": "2026-01-31T17:44:01.064Z",
  "status": "RECEIVED",
  "notificationType": "CREATED",
  "validationError": {
    "errorType": "ALREADY_EXISTS_ERROR",
    "description": "text"
  }
}

200

OK

No content

Real estate token prices Notification

post

Notification related to event RE_TOKEN_PRICES

Body

regularTokennumber · currencyRequired

premiumTokennumber · currencyRequired

Responses

200

OK

post

/re-token-prices

POST /re-token-prices HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "regularToken": 1,
  "premiumToken": 1
}

200

OK

No content

Offboarding Notification

post

Notification about offboarding update related to event OFFBOARDING_NOTIFICATION

Body

offboardingIdstring · uuidRequired

modifiedOnstring · date-timeRequired

statusstring · enumRequiredPossible values:

notificationTypestring · enumRequiredPossible values:

Responses

200

OK

post

/offboarding-notification

POST /offboarding-notification HTTP/1.1
Host: client-api-address
Content-Type: application/json
Accept: */*
Content-Length: 220

{
  "offboardingId": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedOn": "2026-01-31T17:44:01.064Z",
  "status": "CREATED",
  "notificationType": "STARTED",
  "validationError": {
    "errorType": "ALREADY_EXISTS_ERROR",
    "description": "text"
  }
}

200

OK

No content

hashtagCustomer Notification

hashtagLegal Entity Notification

hashtagLegal Representative Notification

hashtagCorporate Action Notification

hashtagNatural Person Notification

hashtagJoint Person Notification

hashtagIdentification Verification Notification

hashtagLabels Update Notification

hashtagOnboarding Notification

hashtagProxy Notification

hashtagBeneficial Owner Notification

hashtagPartner Document Notification

hashtagDocument Notification

hashtagCustomer Product Notification

hashtagLegal Entity Search Notification

hashtagStrategy Notification

hashtagTransfer Notification

hashtagDigital Asset Order Notification

hashtagTraditional Asset Order Notification

hashtagUser Notification

hashtagReal estate token prices Notification

hashtagOffboarding Notification

Customer Notification

Legal Entity Notification

Legal Representative Notification

Corporate Action Notification

Natural Person Notification

Joint Person Notification

Identification Verification Notification

Labels Update Notification

Onboarding Notification

Proxy Notification

Beneficial Owner Notification

Partner Document Notification

Document Notification

Customer Product Notification

Legal Entity Search Notification

Strategy Notification

Transfer Notification

Digital Asset Order Notification

Traditional Asset Order Notification

User Notification

Real estate token prices Notification

Offboarding Notification