v1

latestOpenAPI 3.1.02026-07-2684271522.2 KB
Customers

Delete a customer

Deletes the specified customer. This is a soft delete: the customer is marked as deleted and no longer appears in list or retrieve responses, but historical records that reference the customer (such as payment intents and checkout sessions) continue to resolve it.

delete/v1/customers/{id}

Path parameters

idstring required
Example:fcus_01J9XR8M3K7VZ8N2YB4WJ6T0RA

Response

An envelope wrapping a single customer object.

Example response

{
  "customer": {
    "customer_id": "fcus_01HACM7FZ1084XB1GB6053VM0D",
    "deleted": true
  }
}