Skip to main content

Delete customer address

DELETE 
/v2/customers/:lookupKey/:lookupValue/addresses/:addressId

Delete an existing address for a specific customer with proper validation and cleanup.

Key Features​

  • Flexible Customer Lookup: Delete address using internal ID or external source ID
  • Address Validation: Ensures address exists and belongs to the specified customer
  • Clean Deletion: Removes address completely from the system
  • Default Address Handling: Manages default address reassignment if needed

Business Rules​

  • Address must exist and belong to the specified customer
  • Deletion is permanent and cannot be undone
  • If deleted address was default, system may reassign default status
  • Address cannot be deleted if it's referenced by active orders
  • Source parameter required when using sourceId lookup method

Validation Rules​

  • Customer must exist before address deletion
  • Address ID must be valid and belong to the customer
  • System checks for address dependencies before deletion
  • Proper error handling for non-existent addresses

Use Cases​

  • Address Cleanup: Remove outdated or incorrect addresses
  • Customer Management: Delete addresses during customer data cleanup
  • System Maintenance: Remove addresses as part of data maintenance
  • Address Consolidation: Delete duplicate or redundant addresses

Request​

Responses​

Address deleted successfully with confirmation message