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
- Source account must have sufficient investment units for transfer
- Both source and destination accounts must be active and accessible
- Investment must support transfer operations without restrictions
Important Considerations
⚠️ Critical Implementation Notes
- Beneficial Ownership Flag: NoChangeOfBeneficialOwner determines CGT treatment - TRUE for tax-deferred, FALSE for taxable events
- Regulatory Notification Requirements: Large transfers may require ASIC notification and beneficial ownership disclosure
- Estate Planning Compliance: Transfers must comply with estate planning documentation and tax optimization strategies
- SMSF Sole Purpose Test: SMSF transfers must satisfy sole purpose test and contribution cap requirements
- Cross-Entity Validation: System validates entity relationships and transfer permissions before processing
- AML/CTF Due Diligence: Large or frequent transfers trigger enhanced customer due diligence and monitoring requirements
Description
Processes investment transfers between accounts by simultaneously removing units from the source account and adding them to the destination account. The system handles pricing calculations, tax implications, and maintains complete audit trails for both sides of the transfer.
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 | CGT treatment flag (TRUE=tax-deferred/no CGT event for same owner, FALSE=taxable transfer/CGT event for ownership change). | |
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 settlement date determining pricing and CGT event date (format: YYYY-MM-DD, same date for both from/to transactions, must not be DateOnly.MinValue per controller line 172). | |
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
CGT treatment flag (TRUE=tax-deferred/no CGT event for same owner, FALSE=taxable transfer/CGT event for ownership change).
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 settlement date determining pricing and CGT event date (format: YYYY-MM-DD, same date for both from/to transactions, must not be DateOnly.MinValue per controller line 172).
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"
}
]
}