GET
/Document/File
When to Use
Secure Document File Retrieval - Use this endpoint to download file content associated with document records for member services, compliance verification, and operational processes. Essential for:
- Member Portal Document Access: Enable authenticated members to download their statements, tax documents, distribution notices, and correspondence through secure portals with proper access controls
- Compliance Document Verification: Retrieve KYC/AML documentation, identity verification files, and regulatory compliance certificates for AUSTRAC reporting, ASIC inspections, and internal audit processes
- Audit Trail Documentation: Download supporting documents for transactions, valuations, and corporate actions to support regulatory examinations, dispute resolution, and forensic investigations
- Member Communication Distribution: Access generated statements, annual reports, and notices for printing, email distribution, or postal delivery to members who prefer physical documents
- Regulatory Submission Support: Retrieve documents for ASIC returns, ATO reporting, AUSTRAC submissions, and other regulatory filing requirements with complete audit trails
- Document Versioning and Access: Download current or historical versions of documents for compliance verification, member inquiries, and legal proceedings with full access logging
Common Scenarios
- Member Self-Service Access: Integration with member portals allowing authenticated investors to download their personal documents including statements, tax forms, and investment confirmations
- Compliance Audit Preparation: Bulk retrieval of documents for ASIC surveillance, external audits, or internal compliance reviews with automated access logging and document verification
- Customer Service Operations: Enable support staff to access member documents for inquiry resolution, complaint handling, and account maintenance with appropriate role-based permissions
- Regulatory Response Management: Systematic retrieval of documents for regulatory inquiries, member complaints, or legal proceedings with complete chain of custody documentation
- Business Continuity and Backup: Scheduled downloads of critical documents for disaster recovery, business continuity planning, and off-site storage requirements
- Third-Party Integration: Provide document access to external auditors, legal advisors, or regulatory bodies through controlled API access with comprehensive audit trails
Prerequisites
- Document Access Permissions: Valid Bearer token with 'AccessDocuments' permission and specific rights to the document type, associated entities, and security classification level
- Document File Association: Target document record must exist with successfully uploaded file content - documents without files return 404 with specific error codes
- Entity Relationship Authorization: User must have access to the BizEntity, Product, or Organisation associated with the document based on role-based access controls and data governance policies
- Security Classification Clearance: User access level must meet or exceed the document's security classification (Public, Internal, Confidential, Restricted) as defined in organizational data governance
- Retention Policy Compliance: Document must be within active retention period - archived or expired documents may have restricted access or require special authorization
- System Resource Availability: Adequate bandwidth and storage access for file streaming, particularly important for large files or concurrent access scenarios
Considerations
- Australian Privacy Act Compliance: Downloaded files may contain personal information requiring proper handling per Privacy Act 1988 - ensure recipient systems have appropriate data protection measures
- Access Audit and Compliance Logging: Every download creates permanent audit records including user identity, timestamp, document details, and purpose - essential for Privacy Act breach investigations
- Content Security and Integrity: Files are served with cryptographic integrity checks and appropriate MIME types - validate file integrity and handle security headers properly in client applications
- Bandwidth and Performance Management: Large files (statements with extensive transaction history) may require streaming implementations or download resumption capabilities to prevent timeouts
- Role-Based Access Enforcement: System enforces granular permissions based on user roles, entity associations, and document classifications - unauthorized access attempts are logged and blocked
- Retention Policy and Legal Hold: Document availability is governed by retention schedules and legal hold requirements - some documents may be restricted during litigation or regulatory investigation periods
Description
Downloads the binary file content associated with a document record. Returns the actual file data as a stream with appropriate content headers for PDF statements, compliance documents, forms, and other stored files.
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 | The product identifier for document scope validation. Ensures document belongs to specified product before allowing file download. | |
ExternalProductId |
string | Your external product identifier. Alternative to ProductID for product-scoped document access. | |
DocumentID |
integer | The native 7G identifier for the document. Use this to download file content for a specific document. | |
ExternalDocumentId |
string | Your external system identifier for the document. Alternative to DocumentID for file download. |
ProductID
The product identifier for document scope validation. Ensures document belongs to specified product before allowing file download.
ExternalProductId
Your external product identifier. Alternative to ProductID for product-scoped document access.
DocumentID
The native 7G identifier for the document. Use this to download file content for a specific document.
ExternalDocumentId
Your external system identifier for the document. Alternative to DocumentID for file download.
Example Requests
bash
# Download document by ID
curl -X GET 'https://api.7g.com.au/Document/File?ProductID=100&DocumentID=12345' \
-H "Authorization: {accessToken}" \
-H "Version: 2.0" \
--output downloaded_document.pdf
# Download document by external ID
curl -X GET 'https://api.7g.com.au/Document/File?ExternalProductId=GROWTH_FUND_AU&ExternalDocumentId=INV-STMT-2024-001' \
-H "Authorization: {accessToken}" \
-H "Version: 2.0" \
--output investor_statement.pdfResponse Examples
json
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="Investor_Statement_Q4_2024.pdf"
[Binary file content streamed to client]