# 20 Domains API: How to delete a domain

*This is a series of articles dedicated to demonstrating how to get acquainted with Openprovider Domains API methods.* *To get more information about our API in general, please use our [documentation portal](https://docs.openprovider.com) as your reference.*

When you delete a domain, you immediately terminate your registration of that domain name. In case of registered domains with status ACT, this will result in a deletion at the registry.

***NB** Keep in mind that not all TLDs have support for a [reactivation option](https://openprovider.help/books/api-plugins/page/19-domains-api-how-to-restore-a-domain) and when available this option can be expensive.*

Openprovider doesn’t provide a refund if you have a remaining registration period for your domain. However, domains with status FAI can be deleted to release the amount from your account balance held in reserve for registration.

Learn more about expiration policies [here](https://openprovider.help/books/quick-start/page/renewal-policies-in-openprovider).

<div id="bkmrk-use-endpoint-path-be">![Entering Geo Fence icon](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-twwtijzt.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%2Fdomai">```
<span><strong>DEL</strong> <a href="http://docs.openprovider.com/#operation/"><strong>{base_url}</strong></a>/domains/{id}</span>
```

</div><div id="bkmrk-request-values-name-"><div><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>domain</td><td>string</td><td>**Required.**</td></tr><tr><td>id</td><td>**Required.**</td></tr><tr><td>type</td><td>string</td><td>Optional. Applies only to certain TLDs (e.g. .de)</td></tr></tbody></table>

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

```
curl -X DELETE \<br></br> 'https://api.openprovider.eu/v1beta/domains/12345?domain.name=domain&domain.extension=com' \<br></br> -H 'Authorization: ,Bearer 2f4c1c3a9******15d22b378a64' \
```

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

```
{<br></br> "code": 0,<br></br> "data": {<br></br> "status": "ACT"<br></br> },<br></br> "desc": ""<br></br>}
```

</details>## Restoring a deleted domain

<span>Keep in mind that domain deletion has the following consequences:</span>

- <span>Visitors of your domain don’t see your website if one exists  
    </span>
- <span>Email addresses associated with this domain stops working  
    </span>
- <span>DNS stops serving  
    </span>
- <span>Other people can purchase your domain after a [grace period](https://openprovider.help/books/domains/page/life-cycle-of-a-typical-gtld-domain-name)</span>

</div></div></div>