POST
/BizTransaction/Conversion
When to Use
- Convert between different investment classes or asset categories
- Process fee optimization conversions (retail to wholesale units)
- Execute mandatory conversions during fund restructures or mergers
- Implement corporate action conversion requirements
- Handle portfolio rebalancing between investment types
Prerequisites
- Valid authentication token (see Required Headers)
- Account record must exist in the system
- Source investment (FromInvestmentID) must exist with sufficient holdings
- Target investment (ToInvestmentID) must exist and be active
- Transaction date must be provided (cannot be empty or default value)
Considerations
- Conversion creates TWO linked transaction records: redemption from source investment + deposit to target investment
- Both transactions reference the same account but different investments (FromInvestmentID, ToInvestmentID)
- Transactions are linked via bizTransactionID references for tracking the paired operation
- Transaction records are permanent - corrections require new offsetting transactions
- Use GET /BizTransaction to retrieve both linked records by filtering on ExternalBizTransactionId or account
Description
Creates a conversion transaction that moves holdings from one investment to another within the same account. The operation creates TWO linked transaction records: a redemption from the source investment and a deposit to the target investment, both referencing the same account.
The API validates that a transaction date is provided and returns both transaction records with their system-generated identifiers (BizTransactionID) and linking references. Transaction data can be used for investor statements, reconciliation, and external reporting systems. Both records will share the same ExternalBizTransactionId if provided, enabling easy retrieval of the paired operation.
Required Headers - See Authentication
| Header | Value | Description |
|---|---|---|
| Content-Type | application/json | Request content type |
| Authorization | {accessToken} | Bearer token for API access |
| Version | 2.0 | API version identifier |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
amount |
number (double) | Dollar amount to convert from source investment (creates TWO transactions: from-redemption with calculated negative quantity, to-allotment with conversionFactor-adjusted quantity). | |
conversionFactor |
number (double) | Optional |
Conversion ratio multiplier determining target investment quantity from source quantity (from-quantity × conversionFactor = to-quantity, e.g., 1.0 = equal unit exchange, 0.95 = 5% reduction). |
conversionMethodID |
integer (int32) | Optional |
Conversion calculation method identifier controlling pricing methodology for the conversion operation. |
accountID |
integer (int32) | Native account identifier where conversion executes (same account for both from-redemption and to-allotment transactions within account). | |
externalAccountId |
string | External account identifier for cross-platform integration (resolves to internal accountID for dual-transaction creation). | |
fromComment |
string | Optional |
Audit comment for source investment redemption transaction (appears on account statements under redemption transaction). |
fromExternalBizTransactionId |
string | Optional |
External identifier for source investment redemption transaction preventing duplicate from-investment reductions during integration failures. |
fromInvestmentID |
integer (int32) | Native source investment identifier from which units will be redeemed (creates negative-quantity BizTransaction, system validates sufficient holdings). | |
fromExternalInvestmentId |
string | External source investment identifier for cross-platform integration (resolves to internal fromInvestmentID for holdings validation). | |
quantity |
number (double) | Exact unit quantity to convert from source investment (creates TWO transactions: from-investment with negative quantity, to-investment with quantity × conversionFactor). | |
toComment |
string | Optional |
Audit comment for target investment allotment transaction (appears on account statements under allotment transaction). |
toExternalBizTransactionId |
string | Optional |
External identifier for target investment allotment transaction preventing duplicate to-investment increases during integration failures. |
toInvestmentID |
integer (int32) | Native target investment identifier receiving converted units (creates positive-quantity BizTransaction, must differ from fromInvestmentID). | |
toExternalInvestmentId |
string | External target investment identifier for cross-platform integration (resolves to internal toInvestmentID for holdings update). | |
transactionDate |
string (date) | Transaction date for both conversion records. Format: YYYY-MM-DD. Same date used for both redemption/deposit transactions. Cannot be empty or default value. | |
productID |
integer (int32) | Native product identifier validating both investments and account belong to correct fund structure. | |
externalProductId |
string | External product identifier for cross-system product correlation (resolves to internal productID for validation). |
amount
Dollar amount to convert from source investment (creates TWO transactions: from-redemption with calculated negative quantity, to-allotment with conversionFactor-adjusted quantity).
conversionFactor
Conversion ratio multiplier determining target investment quantity from source quantity (from-quantity × conversionFactor = to-quantity, e.g., 1.0 = equal unit exchange, 0.95 = 5% reduction).
conversionMethodID
Conversion calculation method identifier controlling pricing methodology for the conversion operation.
accountID
Native account identifier where conversion executes (same account for both from-redemption and to-allotment transactions within account).
externalAccountId
External account identifier for cross-platform integration (resolves to internal accountID for dual-transaction creation).
fromComment
Audit comment for source investment redemption transaction (appears on account statements under redemption transaction).
fromExternalBizTransactionId
External identifier for source investment redemption transaction preventing duplicate from-investment reductions during integration failures.
fromInvestmentID
Native source investment identifier from which units will be redeemed (creates negative-quantity BizTransaction, system validates sufficient holdings).
fromExternalInvestmentId
External source investment identifier for cross-platform integration (resolves to internal fromInvestmentID for holdings validation).
quantity
Exact unit quantity to convert from source investment (creates TWO transactions: from-investment with negative quantity, to-investment with quantity × conversionFactor).
toComment
Audit comment for target investment allotment transaction (appears on account statements under allotment transaction).
toExternalBizTransactionId
External identifier for target investment allotment transaction preventing duplicate to-investment increases during integration failures.
toInvestmentID
Native target investment identifier receiving converted units (creates positive-quantity BizTransaction, must differ from fromInvestmentID).
toExternalInvestmentId
External target investment identifier for cross-platform integration (resolves to internal toInvestmentID for holdings update).
transactionDate
Transaction date for both conversion records. Format: YYYY-MM-DD. Same date used for both redemption/deposit transactions. Cannot be empty or default value.
productID
Native product identifier validating both investments and account belong to correct fund structure.
externalProductId
External product identifier for cross-system product correlation (resolves to internal productID for validation).
Example Requests
json
{
"amount": 50000.00,
"conversionFactor": 1.0,
"conversionMethodID": 1,
"accountID": 12345,
"fromComment": "Fee class upgrade - reached wholesale threshold",
"fromExternalBizTransactionId": "CONV-OUT-2024-001",
"fromInvestmentID": 25,
"quantity": null,
"toComment": "Converted to wholesale class - lower fees",
"toExternalBizTransactionId": "CONV-IN-2024-001",
"toInvestmentID": 26,
"transactionDate": "2024-08-14",
"productID": 10
}Response Examples
json
{
"result": true,
"message": "Conversion processed successfully",
"recordCount": 2,
"data": [
{
"bizTransactionID": 2001,
"externalBizTransactionId": "CONV-OUT-2024-001",
"bizTransactionTypeID": 2,
"typeName": "Redemption",
"movementReasonCode": "CONVERSION_OUT",
"parentBizTransactionID": null,
"transactionDate": "2025-08-14T00:00:00Z",
"productID": 10,
"externalProductId": "FUND-001",
"accountID": 12345,
"externalAccountId": "ACC-12345",
"accountNumber": "ACC001234",
"bizEntityName": "Smith Family Trust",
"investmentID": 25,
"externalInvestmentId": "INV-GROWTH-A",
"securityCode": "GRA001",
"investmentName": "Growth Investment Class A",
"investmentPrice": 1.2500,
"comment": "Converting from Growth Class A",
"corporateActionID": null,
"externalCorporateActionId": null,
"corporateActionName": null,
"amount": -50000.00,
"quantity": -40000.00,
"transactionClosingAmount": null,
"transactionClosingQuantity": null,
"accountClosingAmount": null,
"accountClosingQuantity": null,
"createdDate": "2025-08-14T10:30:15Z",
"updatedDate": null,
"bizTransactionStatusID": 1,
"statusName": "Complete"
},
{
"bizTransactionID": 2002,
"externalBizTransactionId": "CONV-IN-2024-001",
"bizTransactionTypeID": 1,
"typeName": "Deposit",
"movementReasonCode": "CONVERSION_IN",
"parentBizTransactionID": null,
"transactionDate": "2025-08-14T00:00:00Z",
"productID": 10,
"externalProductId": "FUND-001",
"accountID": 12345,
"externalAccountId": "ACC-12345",
"accountNumber": "ACC001234",
"bizEntityName": "Smith Family Trust",
"investmentID": 26,
"externalInvestmentId": "INV-GROWTH-B",
"securityCode": "GRB001",
"investmentName": "Growth Investment Class B",
"investmentPrice": 1.2500,
"comment": "Converting to Growth Class B",
"corporateActionID": null,
"externalCorporateActionId": null,
"corporateActionName": null,
"amount": 50000.00,
"quantity": 40000.00,
"transactionClosingAmount": null,
"transactionClosingQuantity": null,
"accountClosingAmount": null,
"accountClosingQuantity": null,
"createdDate": "2025-08-14T10:30:16Z",
"updatedDate": null,
"bizTransactionStatusID": 1,
"statusName": "Complete"
}
]
}