/Report
When to Use
- Generate regulatory reports for statutory lodgement
- Produce tax reporting documents for investor tax return preparation
- Create end-of-period financial statements for board presentations
- Generate transaction audit trails for compliance audits
Prerequisites
- Knowledge of available report names and their parameter requirements
Considerations
- Reports process in background (use returned GUID with GET /Report/Status to monitor completion)
- Simple reports complete in seconds, complex reports may require several minutes
- All parameters must be strings, including numeric IDs ("123") and booleans ("true"/"false")
- Reports are automatically purged after 24 hours
- Maximum 10 concurrent reports per user
Description
Creates a report request in the 7G system, initiating background generation of business intelligence reports, regulatory compliance documents, and operational analysis outputs. Returns a unique GUID reference for tracking the report through processing lifecycle: queuing, generation, completion, and retrieval. The asynchronous architecture supports complex reports requiring significant processing time without blocking API operations.
Report Generation Workflow - 3-Stage Lifecycle
Report processing follows an asynchronous three-stage workflow:
- Request (POST /Report): Submit report type and parameters - receives tracking GUID immediately with "pending" status
- Monitor (GET /Report/Status): Poll processing status with 5-30 second intervals until status changes to "complete" or "error"
- Retrieve (GET /Report): Download results using reference GUID - available for 24 hours before automatic purging
Common Report Types:
- EntityBalanceReport: Balance positions aggregated by entity - used for investor statements and portfolio analysis
- TransactionSummary: Transaction history with type/status filtering - used for SMSF audits and operational reconciliation
- DistributionReconciliation: Distribution calculations with tax components - used for board approval and payment execution
- PerformanceAnalysis: Investment performance with benchmark comparisons - used for client reporting and trustee reviews
- TaxReporting: Annual tax statements and CGT calculations - used for individual tax returns and SMSF compliance
⚠️ Important: Asynchronous Processing and Retrieval
Reports process asynchronously in background workers. Use the returned GUID to check status via GET /Report/Status with appropriate polling intervals (5-30 seconds) before retrieving results via GET /Report. Premature retrieval attempts will fail with 400 errors.
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 |
|---|---|---|---|
reportName |
string | The name of the report to generate. Examples include EntityBalanceReport, TransactionSummary, DistributionReconciliation, and other business intelligence reports. | |
parameters |
object | Optional |
Dynamic collection of report-specific key-value parameters. All values must be strings. Available parameters vary by report type for filtering, grouping, and output control. |
Example Requests
{
"reportName": "EntityBalanceReport",
"parameters": {
"ProductID": "123",
"FromDate": "2024-01-01",
"ToDate": "2024-12-31",
"IncludeClosingBalances": "true"
}
}Response Examples
{
"result": true,
"message": "Your report request has been queued for background processing. Use the Status endpoint with the provided reference value to track its progress.",
"data": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}