🏠 Address Resource Advanced

Direct address management for specialized scenarios

Address records store physical location data for BizEntities, Persons, and Organisations. Most address management occurs through BizEntity operations. Direct Address endpoints support bulk imports, cross-entity updates, and postal validation scenarios.

4
Endpoints
1
Core DTO
3
Entity Types
AU+INT
Address Formats

Usage Notes

When

  • Manage addresses independently of BizEntity for bulk imports or data migration
  • Query address records for cross-entity validation
  • Update addresses across multiple entity associations

Requirements

  • Valid Bearer token with address permissions

Notes

  • Addresses typically created via BizEntity operations; use direct endpoints for specialized scenarios
  • Each address belongs to exactly ONE entity (BizEntity, Person, or Organisation - mutually exclusive)
  • Australian addresses validated against state/postcode combinations
  • Cannot delete addresses referenced by active entity relationships

Available Endpoints

Core Operations

GET Get Addresses Query with postal validation
POST Create Address Create with Australian and international formats
PUT Update Address Update maintaining entity ownership
DELETE Delete Address Remove with entity validation

Core Data Transfer Objects

AddressDTO All Address endpoints Address structure (16 properties) with Australian and international formatting, postal validation (state/postcode), entity ownership (BizEntity, Person, Organisation via dual IDs), and address type classification

Use Cases & Scenarios

Most address management occurs through BizEntity operations. Use direct Address endpoints for bulk address imports, cross-entity updates, postal validation services, or data migration scenarios.

→ See BizEntity Overview for standard entity operations

Business Rules & Constraints

BizEntity Integration & Data Integrity

  • Exclusive ownership: One Address record belongs to ONE entity (BizEntity, Person, OR Organisation)
  • One-to-many support: Entities can have multiple addresses for different purposes (home, work, postal, registered)
  • Referential integrity: Cannot delete address if referenced by active entity relationships
  • BizEntity context: Address creation and management primarily occur through BizEntity operations for relationship integrity

Validation & Compliance Standards

  • Australian addresses require valid state and postcode combinations per Australia Post standards
  • International addresses support country-specific formatting and validation rules
  • Postal validation ensures deliverable addresses for regulatory correspondence requirements
  • Address type validation ensures proper classification for home, work, postal, and registered addresses

Referential Integrity & Management

  • Dual ID system: Native IDs for performance, External IDs for third-party system integration
  • Audit trail: All address changes tracked for compliance and regulatory requirements
  • External integration: ExternalAddressId supports third-party system integration and idempotency