# 9 Customers API: How to delete a handle

*This is a series of articles dedicated to managing customer objects via Openprovider API.*

*This is a fourth article in a series in which we are going to cover customer handle deletion. To get more information about our API in general, please use our [documentation portal](https://docs.openprovider.com) as your reference.*

## <span>Deleting a handle</span>

<span>This article shows how to delete a customer. </span><span>Handle deletion removes an existing customer object and all its records. </span>

***NB** The operation will only succeed if no domains (or other objects) are linked to this customer handle.*

<span>The name of the handle is the only parameter that is required to perform this operation.</span>

<div id="bkmrk-use-endpoint-path-be">![Entering Geo Fence icon](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-tcczsg4p.png)Use endpoint path below. Base URL is determined by both the target environment and API version.</div><div id="bkmrk-del-%7Bbase_url%7D%2Fcusto">```
<span><strong>DEL</strong> <a href="http://docs.openprovider.com/#operation/"><strong>{base_url}</strong></a>/customers/{handle}</span>
```

</div><div id="bkmrk-request-values-name-"><details><summary>REQUEST VALUES</summary>

<table><tbody><tr><td>**<span>Name</span>**</td><td>**<span>Type</span>**</td><td>**<span>Description</span>**</td></tr><tr><td>[handle](https://doc.openprovider.eu/API_Format_Handle)</td><td>string</td><td>**Required.**</td></tr></tbody></table>

</details><div id="bkmrk-request-examplecurl-"><div><details><summary>REQUEST EXAMPLE</summary>

```
curl -L -X DELETE 'https://api.openprovider.eu/v1beta/customers/TP123456-NL' \<br></br> -H 'Authorization: ,Bearer 811eac2d-******-06aa469aeb61' \
```

</details></div><details><summary>RESPONSE EXAMPLE</summary>

```
{<br></br>"code": 0,<br></br>"desc": "",<br></br>"data": {<br></br>"success": true<br></br>}<br></br>}
```

</details><div>Depending on the outcome, one will either receive code 0 (in case of success) or an error code with an error message.</div></div></div>