Delete Address

🔒

Requires write_customer access scope.

Update the details of a specific address for a given customer.

This API is especially useful for:

  1. Modifying a customer's address details.
  2. Updating shipping and billing addresses for orders.
  3. Managing customer profile address information.

Note: The operation is scoped to a specific shop, identified by its unique domain prefix (shopdomain), ensuring all updates are applied to the correct store.

Request Parameters

Public Request Parameters

📘

Public Request Parameters

Path Parameters

ParameterTypeRequiredDescriptionExample
customer_idstringYesUnique identifier of the customer.165618e4-3243-4cd7-abc3-1234567890ab
address_idstringYesUnique identifier of the address.2490dc6a-d511-4e5e-bbcb-d58e913243ad

Response Explanation

Public Response Parameters

📘

Public Response Parameters

Successful Response

Status CodeDescriptionExample Response
200 OKAddress deleted successfully.{}

Error Response

Error responses in the API can be represented using two different fields: errors and error. Both fields provide details about issues encountered during request processing. Below is an explanation of the fields with their respective examples and descriptions.

FieldTypeExampleDescription
errorsEmail or Phone is already taken["Record not found"]A list of errors encountered during the request processing.
FieldTypeExampleDescription
errorString "store is not active"Indicates an error encountered during the process

Error Detail

Status CodeMessagePossible ReasonExample Response
400Bad RequestInvalid input format or request structure (e.g., missing required fields or incorrect data types).Bad Request
UnauthorizedThe request is missing valid authentication credentials or the credentials provided are invalid.Unauthorized
404Record Not FoundThe customer_id and address_id provided is not foundRecord Not Found

API Structure Overview

Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!