---
title: "Delete a customer"
method: DELETE
path: "/v1/customers/{id}"
tags: ["Customers"]
---

# Delete a customer

`DELETE /v1/customers/{id}`

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.

## Path parameters

- `id` string, required

## Response `200`

An envelope wrapping a single customer object.

- CustomerBodyForDeletedCustomerResponse — An envelope wrapping a single customer object.
  - `customer` DeletedCustomerResponse, required — The response returned when a customer is deleted, confirming the deletion.
    - `customer_id` string, required — ID of the deleted Customer.
    - `deleted` boolean, required — Always `true`, confirming the customer was deleted.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Validation Error
- `429` — Too Many Requests

---

[API](https://skmtc.dev/withflex/apis/flex-api.md) · [All operations](https://skmtc.dev/withflex/apis/flex-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withflex/flex-api/revisions/b1560fc2f199/schema)