---
title: "POST /api/customers/{customer_id}/delete/"
method: POST
path: "/api/customers/{customer_id}/delete/"
tags: ["api"]
---

# POST /api/customers/{customer_id}/delete/

`POST /api/customers/{customer_id}/delete/`

## Path parameters

- `customer_id` string, required — The id provided when creating the customer, we suggest matching with your internal customer id in your backend

## Response `200`

- CustomerDeleteResponse
  - `customer_id` string, required
  - `deleted` string, date-time, required
  - `email` string, email, nullable, required
  - `num_subscriptions_deleted` integer, required
  - `num_addons_deleted` integer, required

## Changes

- **2023-02-28** `518705cfc72d` — 1 breaking
  - removed the required property `num_events_deleted` from the response with the `200` status
- **2023-02-20** `d246ebbb528d` — 1 info
  - endpoint added
- **2023-01-16** `36b48cae00a3` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/uselotus/apis/lotus-api/changes/api/customers/:customer_id/delete/post.md)

---

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