Delete Customer

Permanently deletes a customer. This cannot be undone.

Endpoint

DELETE /v1/customers/:id

Authentication

Requires API key authentication via X-API-Key header.

Path Parameters

Parameter	Type	Description
id	string	The customer ID

Example Request

curl -X DELETE https://api.example.com/v1/customers/cus_abc123def456 \
  -H "X-API-Key: sk_live_xxxxx"

Example Response

{
  "id": "cus_abc123def456",
  "object": "customer",
  "deleted": true
}

Notes

• Deleting a customer will not delete associated charges or invoices

• Associated charges and invoices will have their customerId set to null

• This action cannot be undone

Errors

Code	Description
401	Invalid or missing API key
404	Customer not found or doesn't belong to your merchant account