POST
/BizTransaction/Transfer
When to Use
- Transfer investments between different legal entities or accounts
- Process estate planning transitions between family members
- Execute SMSF contributions and withdrawal transfers
- Consolidate holdings across multiple accounts
- Handle beneficial ownership changes with appropriate tax treatment
Prerequisites
- Valid authentication token (see Required Headers)
- Source account (FromAccountID) must exist with sufficient holdings
- Target account (ToAccountID) must exist in the system
- Both accounts must reference the same investment
- Transaction date must be provided (cannot be empty or default value)
Considerations
- Transfer creates TWO linked transaction records: redemption from source account + deposit to target account
- Both transactions reference the same investment but different accounts (FromAccountID, ToAccountID)
- 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
Description
Creates a transfer transaction that moves holdings from one account to another within the same investment. The operation creates TWO linked transaction records: a redemption from the source account and a deposit to the target account, both referencing the same investment.
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 |
|---|---|---|---|
price |
number (double) | Manual price override when priceMethod='Override' (applies to both from-reduction and to-increase transactions). | |
quantity |
number (double) | Exact unit quantity to transfer (creates TWO BizTransaction records: from-account with negative quantity, to-account with positive quantity). | |
priceMethod |
string | Pricing method for both transactions (values: 'Market'=current investmentPrice, 'Book'=historical cost base, 'Override'=manual price parameter). | |
noChangeOfBeneficialOwner |
boolean | Beneficial owner flag indicating whether the transfer involves a change of beneficial ownership (TRUE=no change, FALSE=change of owner). | |
investmentID |
integer (int32) | Native investment identifier (transfers within SAME investment across accounts, for investment switching use Conversion endpoint instead). | |
externalInvestmentId |
string | External investment identifier for cross-platform integration. | |
fromAccountID |
integer (int32) | Source account identifier (creates negative-quantity transaction reducing holdings, can belong to different BizEntity than to-account). | |
fromExternalAccountId |
string | External source account identifier for cross-platform integration. | |
fromComment |
string | Optional |
Comment for outgoing transfer transaction (appears on from-account investor statements). |
fromExternalBizTransactionId |
string | Optional |
External identifier for outgoing transfer transaction for idempotency (separate from to-transaction ID). |
toAccountID |
integer (int32) | Destination account identifier (creates positive-quantity transaction increasing holdings, can belong to different BizEntity than from-account). | |
toExternalAccountId |
string | External destination account identifier for cross-platform integration. | |
toComment |
string | Optional |
Comment for incoming transfer transaction (appears on to-account investor statements). |
toExternalBizTransactionId |
string | Optional |
External identifier for incoming transfer transaction for idempotency (separate from from-transaction ID). |
transactionDate |
string (date) | Transaction date for both transfer records. Format: YYYY-MM-DD. Same date used for both from/to transactions. Cannot be empty or default value. | |
productID |
integer (int32) | Native product identifier validating investment and accounts belong to correct fund structure. | |
externalProductId |
string | External product identifier for cross-system product correlation. |
price
Manual price override when priceMethod='Override' (applies to both from-reduction and to-increase transactions).
quantity
Exact unit quantity to transfer (creates TWO BizTransaction records: from-account with negative quantity, to-account with positive quantity).
priceMethod
Pricing method for both transactions (values: 'Market'=current investmentPrice, 'Book'=historical cost base, 'Override'=manual price parameter).
noChangeOfBeneficialOwner
Beneficial owner flag indicating whether the transfer involves a change of beneficial ownership (TRUE=no change, FALSE=change of owner).
investmentID
Native investment identifier (transfers within SAME investment across accounts, for investment switching use Conversion endpoint instead).
externalInvestmentId
External investment identifier for cross-platform integration.
fromAccountID
Source account identifier (creates negative-quantity transaction reducing holdings, can belong to different BizEntity than to-account).
fromExternalAccountId
External source account identifier for cross-platform integration.
fromComment
Comment for outgoing transfer transaction (appears on from-account investor statements).
fromExternalBizTransactionId
External identifier for outgoing transfer transaction for idempotency (separate from to-transaction ID).
toAccountID
Destination account identifier (creates positive-quantity transaction increasing holdings, can belong to different BizEntity than from-account).
toExternalAccountId
External destination account identifier for cross-platform integration.
toComment
Comment for incoming transfer transaction (appears on to-account investor statements).
toExternalBizTransactionId
External identifier for incoming transfer transaction for idempotency (separate from from-transaction ID).
transactionDate
Transaction date for both transfer records. Format: YYYY-MM-DD. Same date used for both from/to transactions. Cannot be empty or default value.
productID
Native product identifier validating investment and accounts belong to correct fund structure.
externalProductId
External product identifier for cross-system product correlation.
Example Requests
json
{
"price": 0,
"quantity": 50000.00,
"priceMethod": "Market",
"noChangeOfBeneficialOwner": true,
"investmentID": 25,
"externalInvestmentId": "",
"fromAccountID": 12345,
"fromExternalAccountId": "",
"fromComment": "Transfer to spouse account - tax deferred",
"fromExternalBizTransactionId": "TRF-OUT-2024-001",
"toAccountID": 12346,
"toExternalAccountId": "",
"toComment": "Received from spouse account - tax deferred",
"toExternalBizTransactionId": "TRF-IN-2024-001",
"transactionDate": "2025-08-14",
"productID": 10,
"externalProductId": ""
}Response Examples
json
{
"result": true,
"message": "Transfer processed successfully",
"recordCount": 2,
"data": [
{
"bizTransactionID": 6001,
"externalBizTransactionId": "TRF-OUT-2024-001",
"bizTransactionTypeID": 4,
"typeName": "Transfer Out",
"movementReasonCode": "ACCOUNT_TRANSFER",
"parentBizTransactionID": null,
"transactionDate": "2025-08-14T00:00:00Z",
"productID": 10,
"externalProductId": "FUND-001",
"accountID": 12345,
"externalAccountId": "ACC-12345",
"accountNumber": "ACC001234",
"bizEntityName": "John Smith",
"investmentID": 25,
"externalInvestmentId": "INV-GROWTH",
"securityCode": "GRW001",
"investmentName": "Growth Investment Class A",
"investmentPrice": 1.2500,
"comment": "Transfer to spouse account - tax deferred",
"corporateActionID": null,
"externalCorporateActionId": null,
"corporateActionName": null,
"amount": -62500.00,
"quantity": -50000.00,
"transactionClosingAmount": null,
"transactionClosingQuantity": null,
"accountClosingAmount": null,
"accountClosingQuantity": null,
"createdDate": "2025-08-14T10:30:15Z",
"updatedDate": null,
"bizTransactionStatusID": 1,
"statusName": "Complete"
},
{
"bizTransactionID": 6002,
"externalBizTransactionId": "TRF-IN-2024-001",
"bizTransactionTypeID": 8,
"typeName": "Transfer In",
"movementReasonCode": "ACCOUNT_TRANSFER",
"parentBizTransactionID": null,
"transactionDate": "2025-08-14T00:00:00Z",
"productID": 10,
"externalProductId": "FUND-001",
"accountID": 12346,
"externalAccountId": "ACC-12346",
"accountNumber": "ACC001235",
"bizEntityName": "Mary Smith",
"investmentID": 25,
"externalInvestmentId": "INV-GROWTH",
"securityCode": "GRW001",
"investmentName": "Growth Investment Class A",
"investmentPrice": 1.2500,
"comment": "Received from spouse account - tax deferred",
"corporateActionID": null,
"externalCorporateActionId": null,
"corporateActionName": null,
"amount": 62500.00,
"quantity": 50000.00,
"transactionClosingAmount": null,
"transactionClosingQuantity": null,
"accountClosingAmount": null,
"accountClosingQuantity": null,
"createdDate": "2025-08-14T10:30:16Z",
"updatedDate": null,
"bizTransactionStatusID": 1,
"statusName": "Complete"
}
]
}