Delete Customer

This endpoint allows you to permanently delete a customer from the system.

Request

curl --request DELETE \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/customers/C-12345' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}'

Parameters

• customer_number (string, required): The customer number of the customer to delete

Response

Successful Deletion

{
	"message": "Customer deleted successfully."
}

A successful deletion returns a success message.

Error Codes

• 401 Unauthorized: Invalid or missing authentication
• 404 Not Found: Customer with the specified customer number was not found
• 500 Internal Server Error: Customer could not be deleted. This may occur if the customer has related records that prevent deletion.

Notes

• Deleting a customer is a permanent action and cannot be undone
• A customer may not be deletable if related records exist (e.g., projects, invoices, quotes)
• Make sure you use the correct customer number before executing the deletion
• Verify that the user has the necessary permissions to delete customers
• In many cases, it is preferable to set the customer status to "Inactive" rather than deleting the customer

Example

DELETE /api/v1/customers/C-12345

Response on Success:

{
	"message": "Customer deleted successfully."
}

Response on Error (500):

{
	"message": "Customer could not be deleted."
}