Retrieve all addresses associated with a customer, with optional filtering by address type.

Filtering:

• billing: Returns only addresses marked as default billing
• shipping: Returns only addresses marked as default shipping
• No filter: Returns all addresses for the customer

Address Types: A single address can serve as both billing and shipping default simultaneously. This is determined by the is_default_billing and is_default_shipping flags.

Deduplication: Addresses are automatically deduplicated based on their content hash. If the same address data is used for both billing and shipping, only one record exists with both flags set.