> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lms.bsa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a customer

> Permanently remove a customer record.

<Warning>
  Deletion is only permitted while a customer is in **pending** state.
  Because customers created via this API are activated immediately,
  partner-created customers are effectively never deletable — use
  [Close](/customers/close) instead.
</Warning>

Two equivalent forms — see [Addressing a customer](/customers/overview#addressing-a-customer).

## Path parameters

<ParamField path="customer_id" type="string" required>
  LMS id, or the externalId on the
  `/external/{customer_external_id}` form.
</ParamField>

## Examples

```bash theme={null}
# By LMS id
curl -sf -X DELETE "$BASE/v1/customers/42" \
  -H "Authorization: Bearer $TOKEN"

# By externalId
curl -sf -X DELETE "$BASE/v1/customers/external/ext-ada-001" \
  -H "Authorization: Bearer $TOKEN"
```

## Response

`200 OK` with an empty body.

## Errors

| Code        | When                                                      |
| ----------- | --------------------------------------------------------- |
| `not_found` | No customer with that ID                                  |
| `aborted`   | Customer is not in pending state, or has associated loans |