DELETE
/Investment
When to Use
- Remove test investment products created during development or integration testing
- Delete cancelled investment options before launch or regulatory approval
- Clean up duplicate investment records from data migration errors
- Remove investment configurations with errors before any financial activity
Prerequisites
- Investment must have no transactions, price records, or distribution history
Considerations
- Investments with transaction history cannot be deleted (protects audit trail)
- All investment price records must be deleted first using DELETE /Investment/Price
- Deletion is permanent with no recovery mechanism
- Recommended: Set IsActive=false instead of deletion to maintain audit trail
- Zero-balance investor accounts linked to the investment may prevent deletion
Description
Permanently deletes an investment product from the 7G platform. This operation has strict business rules to prevent accidental deletion of investments with active financial data or transaction history.
Required Headers - See Authentication
| Header | Value | Description |
|---|---|---|
| Authorization | {accessToken} | Bearer token for API access |
| Version | 2.0 | API version identifier |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
ProductID |
integer | Native 7G product identifier for ownership validation during deletion. | |
ExternalProductId |
string | Client product reference for ownership validation during deletion. | |
InvestmentID |
int | Native 7G investment identifier (most efficient deletion method). | |
ExternalInvestmentId |
string(50) | Client investment identifier (requires ProductID or ExternalProductId for scoping). |
ProductID
Native 7G product identifier for ownership validation during deletion.
ExternalProductId
Client product reference for ownership validation during deletion.
InvestmentID
Native 7G investment identifier (most efficient deletion method).
ExternalInvestmentId
Client investment identifier (requires ProductID or ExternalProductId for scoping).
Parameter Options
Choose one of these identification methods:
- Option 1: investmentID only (most efficient)
- Option 2: productID + externalInvestmentId
- Option 3: externalProductId + externalInvestmentId
- Option 4: productID + investmentID (for additional validation)
Note: All combinations validate product ownership before deletion.
Example Requests
bash
# Delete investment by ID only
curl -X DELETE "https://api.7g.com.au/Investment?InvestmentID=12345" \
-H "Authorization: {accessToken}" \
-H "Version: 2.0"
# Delete by product ID and investment ID (recommended for validation)
curl -X DELETE "https://api.7g.com.au/Investment?ProductID=100&InvestmentID=12345" \
-H "Authorization: {accessToken}" \
-H "Version: 2.0"
# Delete by external IDs combination
curl -X DELETE "https://api.7g.com.au/Investment?ExternalProductId=FUND-001&ExternalInvestmentId=INV-001" \
-H "Authorization: {accessToken}" \
-H "Version: 2.0"
# Delete by product ID and external investment ID
curl -X DELETE "https://api.7g.com.au/Investment?ProductID=100&ExternalInvestmentId=INV-001" \
-H "Authorization: {accessToken}" \
-H "Version: 2.0"Response Examples
json
{
"result": true,
"message": "Investment deleted successfully",
"recordCount": 0,
"data": null
}