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

# Delete a customer

`DELETE /accounts/customers/{customerId}`

## Request

- Base URL: `https://api-sb.meld.io`
- URL: `https://api-sb.meld.io/accounts/customers/{customerId}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/meld/apis/bank-linking/docs/accounts/customers/:customerId/delete.ts> (a function with typed inputs; its response is checked against the schema)

Use this endpoint to delete a customer with Meld and/or with any of the service providers it is linked to. This endpoint should only be used for customers using the Bank-Linking stack, as it is not yet compatible with the Payments or Crypto stack. If a customer is deleted that is linked to a Payments or Crypto service provider customer, it will still be deleted with Meld, but not with the provider.

***Note:*** For customers using the Bank-Linking stack, this will delete all of the customer's connections and financial accounts as well.

## Path parameters

- `customerId` string, required

## Query parameters

- `serviceProviders` string

## Response `200`

Customer is deleted

- CustomerDeletedResponse
  - `id` string, required: The id of the customer deleted
  - `isDeleted` boolean, required: True if the Meld customer was deleted as well and can no longer be used anymore. This will only be true if no service providers were passed into the request
  - `serviceProviderCustomersDeleted` object: The service provider customers deleted for this customer, if any. A map of the service provider to the provider's id for the customer

## Other responses

- `400`: Bad Request : check request values and format
- `401`: Invalid credentials
- `403`: Unauthenticated or authenticated with insufficient access
- `404`: Customer cannot be found
- `409`: Customer already deleted
- `500`: Server Error. This applies to all 5xx errors, including but not limited to 500, 501, 502, 503, and 504 errors. You should treat all of these errors the same.

---

[API](https://skmtc.dev/meld/apis/bank-linking.md) - [All operations](https://skmtc.dev/meld/apis/bank-linking/llms.txt) - [OpenAPI document](https://skmtc.dev/meld/apis/bank-linking/revisions/818d6079a611?raw)