Person Resource Advanced
Direct person record management for specialized scenarios
Direct access to person record management, typically used for bulk imports, cross-entity person management, and specialized KYC/AML workflows. Most person creation and management should occur through BizEntity operations, which handle complete investor setups with proper relationship management and deduplication.
Individual Identity Hub
Central repository for individual person records supporting investor onboarding, regulatory compliance, and complex organizational hierarchies with KYC/AML data management.
Multi-Entity Integration
BizEntityParty relationship model enabling one person to hold multiple roles across different entities - investor, signatory, controller, or associated party with ownership tracking.
Compliance & Identification
Personal data including names, birth dates, identification documents, tax residency, and external system references for regulatory compliance and audit requirements.
Available Endpoints
Core Operations
Core Data Transfer Objects
Use Cases & Scenarios
Investor Onboarding
Complete KYC/AML individual onboarding with personal details, identification verification, and regulatory compliance data collection.
Corporate Entity Management
Manage persons within corporate structures including directors, shareholders, signatories, and beneficial owners with role-based relationships.
Multi-Entity Relationships
Handle individuals with multiple entity relationships across different investment vehicles, trusts, and corporate structures.
Compliance & Reporting
Maintain regulatory compliance with person identification, beneficial ownership reporting, and AUSTRAC requirements.
Most person management occurs through BizEntity operations. Use direct Person endpoints for bulk imports, cross-entity updates, standalone KYC collection, or data migration scenarios.
→ See BizEntity Overview for standard entity operations
Business Rules & Constraints
BizEntity Integration & Deduplication
- Automatic Deduplication: When creating persons through BizEntity operations, the system automatically deduplicates based on
externalPersonId - Reuse Pattern: Same
externalPersonIdin multiple locations within a BizEntity request creates ONE person record - Multi-role support: Person records link to BizEntity through BizEntityParty relationships with defined roles (investor, signatory, controller, beneficial owner)
- Flexible ownership: Multiple entity relationships supported with different capacity types and shareholding percentages
Validation & Compliance Standards
- Age validation: Date of birth validation ensures logical age restrictions for investment eligibility
- Identification requirements: Passport, driver's license, and other ID validation for KYC/AML compliance
- Tax residency: Support for up to three tax jurisdictions with TIN tracking and reporting requirements
- Compliance workflows: Significant person changes (name, identification) trigger entity validation and compliance update workflows
Referential Integrity & Management
- Deletion restrictions: Person records cannot be deleted if active BizEntityParty relationships exist
- External integration: ExternalPersonId supports third-party system integration and idempotency
- Contact management: Communication and Address records link through entity relationships, enabling multiple addresses and communications per person
🔗 Ecosystem Integration Patterns
Person records integrate across the 7G ecosystem through BizEntity relationships, supporting investor structures and compliance workflows:
BizEntity Primary Integration
Automatic person deduplication and relationship management through BizEntity operations.
Corporate Structure Integration
Multi-role support across entities as investor, signatory, director, or beneficial owner.
Compliance & Reporting
KYC/AML data supports comprehensive compliance reporting and regulatory requirements.