GET
/distribution/account
When to Use
- Retrieve distribution account records for specific distributions
- View distribution allocation calculations and tax withholding details
- Analyze reinvestment elections and account-specific preferences
- Process distribution statements and tax reporting requirements
Common Scenarios
- Distribution Processing: Get all accounts eligible for a specific distribution
- Account Validation: Retrieve individual account distribution records
- Tax Reporting: Extract withholding tax and distribution amounts
- Reinvestment Analysis: Review DRP elections and reinvested quantities
Prerequisites
- Valid Bearer token with distribution read permissions
- Knowledge of distribution (corporateActionID) or account identifiers
- Understanding of distribution processing workflow
Considerations
- Distribution accounts are created during Declare stage (Step 2 of 4) and populated with allocation details
- This read-only endpoint provides visibility at any workflow stage after declaration (Declared/Distributed/Allotted)
- Results are paginated with maximum 1000 records per page
- Default page size is 1000 if not specified
- Native IDs provide better performance than external IDs
- Distribution accounts only exist after distribution declaration
Description
Retrieves distribution account records containing allocation calculations, tax withholding details, and reinvestment preferences for specific distributions. Returns comprehensive account-level distribution data including cumulative balances, withholding tax calculations, and DRP elections.
Distribution Processing States
- Declared: Distribution announced, account records created with calculations
- Distributed: Payments processed, reinvestment allocations completed
- Allotted: Additional units issued for DRP participants
📋 Read-Only Architecture
This endpoint provides read-only access to account-level distribution details.
Account selection and management now occurs at declaration time using the
/Distribution/Declare endpoint's
preCalculatedAccounts, includeAccounts, or excludeAccounts arrays.
This architectural change eliminates the need for separate account management endpoints, providing a cleaner workflow where all account decisions happen during distribution declaration.
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 |
|---|---|---|---|
CorporateActionID |
integer | Optional |
The native 7G identifier for the distribution (corporate action). |
ExternalCorporateActionId |
string | Optional |
Your external identifier for the distribution. |
ProductID |
integer | Optional |
The native 7G identifier for the product. |
ExternalProductId |
string | Optional |
Your external identifier for the product. |
AccountID |
integer | Optional |
The native 7G identifier for a specific account. When provided, returns only that account's distribution record. |
ExternalAccountId |
string | Optional |
Your external identifier for a specific account. When provided, returns only that account's distribution record. |
PageSize |
integer | Optional |
Number of records per page. |
PageNumber |
integer | Optional |
Page number to retrieve (starts from 1). |
CorporateActionID
The native 7G identifier for the distribution (corporate action).
ExternalCorporateActionId
Your external identifier for the distribution.
ProductID
The native 7G identifier for the product.
ExternalProductId
Your external identifier for the product.
AccountID
The native 7G identifier for a specific account. When provided, returns only that account's distribution record.
ExternalAccountId
Your external identifier for a specific account. When provided, returns only that account's distribution record.
PageSize
Number of records per page.
PageNumber
Page number to retrieve (starts from 1).
Example Requests
bash
# Get all distribution accounts for a specific distribution
curl -X GET https://api.7g.com.au/Distribution/Account?CorporateActionID=789 \
-H "Authorization: {accessToken}" \
-H "Version: 2.0"
# Get distribution accounts with pagination
curl -X GET "https://api.7g.com.au/Distribution/Account?CorporateActionID=789&PageSize=50&PageNumber=1" \
-H "Authorization: {accessToken}" \
-H "Version: 2.0"
# Get specific distribution account record
curl -X GET "https://api.7g.com.au/Distribution/Account?CorporateActionID=789&AccountID=12345" \
-H "Authorization: {accessToken}" \
-H "Version: 2.0"
# Using external IDs
curl -X GET "https://api.7g.com.au/Distribution/Account?ExternalCorporateActionId=DIST-2024-Q4&ExternalAccountId=ACC-001" \
-H "Authorization: {accessToken}" \
-H "Version: 2.0"Response Examples
json
{
"result": true,
"message": null,
"recordCount": 2,
"data": [
{
"corporateActionID": 789,
"externalCorporateActionId": "DIST-2024-Q4",
"productID": 100,
"externalProductId": "FUND-001",
"accountID": 12345,
"externalAccountId": "ACC-001",
"accountNumber": "7G-12345",
"bizEntityName": "Smith Super Fund",
"cumBalance": 50000.00,
"daysInPossession": 92,
"drpTypeID": 1,
"drpValue": 100.0,
"fee": 10.00,
"grossDistribution": 625.00,
"reinvestedAmount": 625.00,
"reinvestedPrice": 2.50,
"reinvestedQuantity": 250.00,
"taxationCountryCode": "AUS",
"transferredFunds": 0.00,
"withholdingTax": 0.00,
"withholdingTaxRefunded": 0.00
},
{
"corporateActionID": 789,
"externalCorporateActionId": "DIST-2024-Q4",
"productID": 100,
"externalProductId": "FUND-001",
"accountID": 12346,
"externalAccountId": "ACC-002",
"accountNumber": "7G-12346",
"bizEntityName": "Jones Family Trust",
"cumBalance": 75000.00,
"daysInPossession": 92,
"drpTypeID": 2,
"drpValue": 0.0,
"fee": 15.00,
"grossDistribution": 937.50,
"reinvestedAmount": 0.00,
"reinvestedPrice": null,
"reinvestedQuantity": null,
"taxationCountryCode": "AUS",
"transferredFunds": 922.50,
"withholdingTax": 0.00,
"withholdingTaxRefunded": 0.00
}
]
}