Sample - Stripe API
DELETE/v1/customers/{customer}

Delete a customer

Deletes a customer and permanently removes the customer record. Active subscriptions for the customer are cancelled immediately, and the deletion cannot be undone.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter
customerstringrequired
The unique identifier of the customer to delete; the value must be no longer than 5,000 characters.

2 status codes
200Returns a deleted customer object with `deleted` set to true, the customer's unique `id`, and `object` set to `customer`.
deletedbooleanrequired
Always true for a deleted object
Allowed:true
idstringrequired
Unique identifier for the object.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:customer
defaultReturned when the API cannot process the deletion and provides an error object.
errorobjectrequired

Error handling

customer must be a string no longer than 5,000 characters and must identify the customer to delete. The request body has no defined fields, and deletion permanently cancels any active subscriptions.