👤 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.

4
Endpoints
3
Core DTOs
KYC/AML
Compliance
Multi
Entity Roles
👤

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

GET Get Persons Query with multi-entity relationship filtering
POST Create Person Create with KYC/AML compliance data
PUT Update Person Update maintaining entity relationships
DELETE Delete Person Remove with relationship validation

Core Data Transfer Objects

PersonDTO All Person endpoints Individual identity structure (46 properties) with personal names, birth date, identification documents (passport, driver's license), tax residency (up to 3 jurisdictions), KYC/AML classifications, and 2 nested arrays (Addresses, Communications)
BizEntityPartyDTO Entity relationships (referenced) Person-to-entity links with roles and shareholding (13 properties)
AssociatedPersonDTO Complex entity structures (nested) Associated persons in organizational contexts (9 properties)

Use Cases & Scenarios

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 externalPersonId in 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