Transaction History

Get Transaction

get
/transactions/{transactionId}

Get Transaction

Authorizations
OAuth2clientCredentialsRequired
Token URL:
Path parameters
transactionIdstring · uuidRequired

Unique transaction identification number in UUID format

Responses
200

OK

application/json
get
/transactions/{transactionId}
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-11-18T08:59:50.882Z",
  "modifiedOn": "2025-11-18T08:59:50.882Z",
  "transactionType": "TRADE",
  "transactionStatus": "MODIFIED",
  "bookingDate": "2025-11-18",
  "valueDate": "2025-11-18",
  "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-11-18",
    "orderStatus": "RECEIVED",
    "externalId": "text",
    "executionData": {
      "quantity": 1,
      "executionPrice": 1,
      "executionAmount": 750.55,
      "remainingQuantity": 1,
      "feeDescription": "text",
      "feeAmount": 1,
      "germanCit": 1,
      "solidaritySurcharge": 1,
      "churchTax": 1
    },
    "partialExecutions": [
      {
        "executionId": "123e4567-e89b-12d3-a456-426614174000",
        "executionPrice": 1,
        "executionQuantity": 1,
        "amount": -1523.25,
        "executionTime": "2025-11-18T08:59:50.882Z",
        "valueDate": "2025-11-18",
        "bookingDate": "2025-11-18",
        "status": "RECEIVED",
        "taxData": [
          {
            "germanCit": 1,
            "solidaritySurcharge": 1,
            "churchTax": 1
          }
        ]
      }
    ]
  },
  "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"
  },
  "corporateActionTransaction": {
    "corporateActionId": "123e4567-e89b-12d3-a456-426614174000",
    "corporateActionCustomerId": "123e4567-e89b-12d3-a456-426614174000",
    "actionType": "DVCA",
    "isin": "text",
    "executionDate": "2025-11-18",
    "depositoryCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
    "eligibleQuantity": 1,
    "cashCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
    "grossAmountPerShare": 1,
    "netAmount": 1,
    "currency": "EUR",
    "taxData": {
      "germanCit": 1,
      "solidaritySurcharge": 1,
      "churchTax": 1
    }
  }
}

Get Transactions

get
/customers/{customerId}/transactions

Get a list of historic transactions.

Authorizations
OAuth2clientCredentialsRequired
Token URL:
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
get
/customers/{customerId}/transactions
GET /customers/{customerId}/transactions?limit=20 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-11-18T08:59:50.882Z",
      "modifiedOn": "2025-11-18T08:59:50.882Z",
      "transactionType": "TRADE",
      "transactionStatus": "MODIFIED",
      "bookingDate": "2025-11-18",
      "valueDate": "2025-11-18",
      "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-11-18",
        "orderStatus": "RECEIVED",
        "externalId": "text",
        "executionData": {
          "quantity": 1,
          "executionPrice": 1,
          "executionAmount": 750.55,
          "remainingQuantity": 1,
          "feeDescription": "text",
          "feeAmount": 1,
          "germanCit": 1,
          "solidaritySurcharge": 1,
          "churchTax": 1
        },
        "partialExecutions": [
          {
            "executionId": "123e4567-e89b-12d3-a456-426614174000",
            "executionPrice": 1,
            "executionQuantity": 1,
            "amount": -1523.25,
            "executionTime": "2025-11-18T08:59:50.882Z",
            "valueDate": "2025-11-18",
            "bookingDate": "2025-11-18",
            "status": "RECEIVED",
            "taxData": [
              {
                "germanCit": 1,
                "solidaritySurcharge": 1,
                "churchTax": 1
              }
            ]
          }
        ]
      },
      "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"
      },
      "corporateActionTransaction": {
        "corporateActionId": "123e4567-e89b-12d3-a456-426614174000",
        "corporateActionCustomerId": "123e4567-e89b-12d3-a456-426614174000",
        "actionType": "DVCA",
        "isin": "text",
        "executionDate": "2025-11-18",
        "depositoryCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
        "eligibleQuantity": 1,
        "cashCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
        "grossAmountPerShare": 1,
        "netAmount": 1,
        "currency": "EUR",
        "taxData": {
          "germanCit": 1,
          "solidaritySurcharge": 1,
          "churchTax": 1
        }
      }
    }
  ],
  "pagination": {
    "cursor": "text",
    "limit": 1
  }
}

Last updated