POST
/Document/Statement
When to Use
- Generate distribution statements for specific corporate actions with tax component breakdowns
- Create member account activity statements for specified date ranges
- Produce annual tax statements for financial year-end reporting
- Generate statements dynamically in response to member portal requests
Prerequisites
- Statement templates configured for requested statementTypeID
Considerations
- Statement generation is resource-intensive for large transaction histories
- Large date ranges may cause performance issues
- Returns PDF stream, not JSON (handle file downloads appropriately)
- Consider automatic storage to Document records for compliance
Description
Generates customized investor statements using configured templates and returns the statement as a binary PDF file stream. Statements include transaction history, balances, distributions, and tax information for specified periods and entities.
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 |
|---|---|---|---|
statementTypeID |
integer | Statement type classification reference via common/lookup. Determines template selection, data inclusion, required fields, and validation logic for statement generation. | |
ProductID |
integer | The product identifier for statement generation. Required for all statement types. If ProductID > 0, it takes precedence over ExternalProductId. | |
externalProductId |
string | Your external product identifier. Required for all statement types when ProductID is not provided or equals 0. | |
InvestmentID |
integer | Optional |
The investment identifier to include in statement. Filter to specific investments within a product. |
externalInvestmentId |
string | Optional |
Your external investment identifier. Alternative to investmentID for investment-specific statements. |
CorporateActionID |
integer | The corporate action identifier for distribution statement generation. Mandatory for distribution statements. | |
externalCorporateActionId |
string | Your external corporate action identifier. Required for distribution statements when CorporateActionID is not provided or equals 0. | |
BizEntityID |
integer | The business entity identifier for statement generation. Mandatory for all statement types. | |
externalBizEntityId |
string | Your external business entity identifier. Required for all statement types when BizEntityID is not provided or equals 0. | |
OrganisationID |
integer | Optional |
The organisation identifier to generate statement for. Filter to specific organisations. |
externalOrganisationId |
string | Optional |
Your external organisation identifier. Alternative to organisationID for organisation-specific statements. |
fromDate |
string (date) | Start date for transaction statement period in YYYY-MM-DD format. Mandatory for transaction statements. | |
toDate |
string (date) | End date for statement period in YYYY-MM-DD format. Mandatory for transaction and tax statements. Tax statements require valid financial year end date. | |
code |
string | Optional |
Statement reference code for identification and tracking purposes. |
statementTypeID
Statement type classification reference via common/lookup. Determines template selection, data inclusion, required fields, and validation logic for statement generation.
ProductID
The product identifier for statement generation. Required for all statement types. If ProductID > 0, it takes precedence over ExternalProductId.
externalProductId
Your external product identifier. Required for all statement types when ProductID is not provided or equals 0.
InvestmentID
The investment identifier to include in statement. Filter to specific investments within a product.
externalInvestmentId
Your external investment identifier. Alternative to investmentID for investment-specific statements.
CorporateActionID
The corporate action identifier for distribution statement generation. Mandatory for distribution statements.
externalCorporateActionId
Your external corporate action identifier. Required for distribution statements when CorporateActionID is not provided or equals 0.
BizEntityID
The business entity identifier for statement generation. Mandatory for all statement types.
externalBizEntityId
Your external business entity identifier. Required for all statement types when BizEntityID is not provided or equals 0.
OrganisationID
The organisation identifier to generate statement for. Filter to specific organisations.
externalOrganisationId
Your external organisation identifier. Alternative to organisationID for organisation-specific statements.
fromDate
Start date for transaction statement period in YYYY-MM-DD format. Mandatory for transaction statements.
toDate
End date for statement period in YYYY-MM-DD format. Mandatory for transaction and tax statements. Tax statements require valid financial year end date.
code
Statement reference code for identification and tracking purposes.
Statement Types & Required Fields
| Type ID | Statement Type | Required Fields | Purpose |
|---|---|---|---|
| 1 | Distribution Statement | corporateActionID or externalCorporateActionIdbizEntityID or externalBizEntityId |
AMIT-compliant distribution statements with tax component details, franking credits, and ATO reporting information for specific corporate actions |
| 2 | Transaction Statement | fromDate and toDate (both required)bizEntityID or externalBizEntityId |
Member account activity for specified date range including unit applications/redemptions, fee deductions, balance changes, and transaction history |
| 3 | Tax Statement | toDate (validates financial year)bizEntityID or externalBizEntityId |
Annual tax information for ATO reporting including distribution components, franking credits, capital gains, and financial year summaries. System validates toDate corresponds to valid financial year end |
Regulatory Requirements: All statements must include required disclaimers, PDS references, and contact information per ASIC RG97 and Corporations Act 2001. Retention period: 7 years minimum.
Example Requests
json
{
"statementTypeID": 1,
"productID": 100,
"bizEntityID": 12345,
"fromDate": "2024-01-01",
"toDate": "2024-12-31",
"code": "ANNUAL-2024"
}Response Examples
json
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="Investment_Statement_2024.pdf"
[Binary file content streamed to client]