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
      • Digital assets
        • Create Order
        • General
        • Assets
        • 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
Export as PDF
  1. API REFERENCE

Transaction History

Last updated 23 days ago

Get Transaction

get

Get Transaction

Authorizations
Path parameters
transactionIdstring · uuidRequired

Unique transaction identification number in UUID format

Responses
200
OK
application/json
400
Bad Request
application/json
404
Not Found
application/json
get
GET /transactions/{transactionId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
  "transactionId": "123e4567-e89b-12d3-a456-426614174000",
  "customerId": "123e4567-e89b-12d3-a456-426614174000",
  "createdOn": "2025-06-13T07:46:44.864Z",
  "modifiedOn": "2025-06-13T07:46:44.864Z",
  "transactionType": "TRADE",
  "transactionStatus": "MODIFIED",
  "bookingDate": "2025-06-13",
  "valueDate": "2025-06-13",
  "digitalTradingTransaction": {
    "orderId": "123e4567-e89b-12d3-a456-426614174000",
    "walletCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
    "cashCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
    "tradeSide": "BUY",
    "cryptoSymbol": "text",
    "assetType": "CRYPTOCURRENCY",
    "quantity": 1,
    "price": 1,
    "amount": 750.55,
    "currency": "EUR",
    "externalId": "text"
  },
  "traditionalTradingTransaction": {
    "orderId": "123e4567-e89b-12d3-a456-426614174000",
    "depositoryCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
    "cashCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
    "isin": "text",
    "exchangeCode": "TGAT",
    "assetType": "BOND",
    "tradeSide": "BUY",
    "quantityType": "UNIT",
    "quantity": 1,
    "currency": "EUR",
    "orderType": "LIMIT",
    "limitPrice": 1,
    "stopPrice": 1,
    "expiryDate": "2025-06-13",
    "orderStatus": "RECEIVED",
    "executionData": {
      "quantity": 1,
      "executionPrice": 1,
      "executionAmount": 750.55,
      "remainingQuantity": 1,
      "feeDescription": "text",
      "feeAmount": 1,
      "externalId": "text"
    }
  },
  "cashTransaction": {
    "transferId": "123e4567-e89b-12d3-a456-426614174000",
    "referenceMessage": "text",
    "counterpartyName": "text",
    "customerProductId": "123e4567-e89b-12d3-a456-426614174000",
    "iban": "DE39500105172896993442",
    "bic": "text",
    "amount": 1,
    "currency": "EUR",
    "direction": "INCOMING",
    "externalId": "text"
  },
  "technicalCashTransaction": {
    "transferId": "123e4567-e89b-12d3-a456-426614174000",
    "referenceMessage": "text",
    "customerProductId": "123e4567-e89b-12d3-a456-426614174000",
    "amount": 1,
    "currency": "EUR",
    "direction": "INCOMING"
  }
}

Get Transactions

get

Get a list of historic transactions.

Authorizations
Path parameters
customerIdstring · uuidRequired

Unique customer identification number in UUID format

Query parameters
cursorstringOptional

String value used for pagination

limitinteger · min: 1Required

Maximum number of items to return

Default: 20
transactionTypeundefined · enumOptional

The type of transaction being performed.

Possible values:
startBookingDatestring · dateOptional

Display transactions with a Booking Date on or after this date

endBookingDatestring · dateOptional

Display transactions with a Booking Date on or before this date

customerProductIdstring · uuidOptional

Unique customer product identification number in UUID format

Responses
200
OK
application/json
400
Bad Request
application/json
get
GET /customers/{customerId}/transactions HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
  "data": [
    {
      "transactionId": "123e4567-e89b-12d3-a456-426614174000",
      "customerId": "123e4567-e89b-12d3-a456-426614174000",
      "createdOn": "2025-06-13T07:46:44.864Z",
      "modifiedOn": "2025-06-13T07:46:44.864Z",
      "transactionType": "TRADE",
      "transactionStatus": "MODIFIED",
      "bookingDate": "2025-06-13",
      "valueDate": "2025-06-13",
      "digitalTradingTransaction": {
        "orderId": "123e4567-e89b-12d3-a456-426614174000",
        "walletCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
        "cashCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
        "tradeSide": "BUY",
        "cryptoSymbol": "text",
        "assetType": "CRYPTOCURRENCY",
        "quantity": 1,
        "price": 1,
        "amount": 750.55,
        "currency": "EUR",
        "externalId": "text"
      },
      "traditionalTradingTransaction": {
        "orderId": "123e4567-e89b-12d3-a456-426614174000",
        "depositoryCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
        "cashCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
        "isin": "text",
        "exchangeCode": "TGAT",
        "assetType": "BOND",
        "tradeSide": "BUY",
        "quantityType": "UNIT",
        "quantity": 1,
        "currency": "EUR",
        "orderType": "LIMIT",
        "limitPrice": 1,
        "stopPrice": 1,
        "expiryDate": "2025-06-13",
        "orderStatus": "RECEIVED",
        "executionData": {
          "quantity": 1,
          "executionPrice": 1,
          "executionAmount": 750.55,
          "remainingQuantity": 1,
          "feeDescription": "text",
          "feeAmount": 1,
          "externalId": "text"
        }
      },
      "cashTransaction": {
        "transferId": "123e4567-e89b-12d3-a456-426614174000",
        "referenceMessage": "text",
        "counterpartyName": "text",
        "customerProductId": "123e4567-e89b-12d3-a456-426614174000",
        "iban": "DE39500105172896993442",
        "bic": "text",
        "amount": 1,
        "currency": "EUR",
        "direction": "INCOMING",
        "externalId": "text"
      },
      "technicalCashTransaction": {
        "transferId": "123e4567-e89b-12d3-a456-426614174000",
        "referenceMessage": "text",
        "customerProductId": "123e4567-e89b-12d3-a456-426614174000",
        "amount": 1,
        "currency": "EUR",
        "direction": "INCOMING"
      }
    }
  ],
  "pagination": {
    "cursor": "text",
    "limit": 1
  }
}
  • GETGet Transaction
  • GETGet Transactions