---
title: "Delete order"
source_url: https://dev.digicert.com/certcentral-apis/services-api/orders/delete-order.html
api_method: DELETE
api_endpoint: "/services/v2/order/certificate/{{order_id}}/note/{{note_id}}"
api_url: "https://www.digicert.com/services/v2/order/certificate/{{order_id}}"
---

**DELETE** `https://www.digicert.com/services/v2/order/certificate/{{order_id}}`

Use this endpoint to delete an eligible inactive order with the given order ID.


> **Info**
>
> Active orders cannot be deleted. Not all inactive orders are eligible for deletion. You can delete only inactive orders that DigiCert has determined are eligible for deletion based on its internal retention criteria.
>
> Under the current policy, inactive orders whose end of validity date is more than 12 years in the past may be eligible for deletion. Final eligibility is determined by DigiCert and may change over time. To estimate whether an order may be eligible, use the [Order info](order-info.md) endpoint and review the order's <code>certificate.valid_till</code> date in the API response.<br>
>
> Also, deleting an order permanently removes it from your CertCentral account history.


To delete an inactive order and revoke its certificate at the same time, set the optional <code>revoke</code> query parameter to <code>true</code>.

## Example requests and responses

**Delete an order**

```bash
curl -X DELETE \
  https://www.digicert.com/services/v2/order/certificate/{{order_id}} \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'
```

**Delete and revoke in a single request**

```bash
curl -X DELETE \
  https://www.digicert.com/services/v2/order/certificate/{{order_id}}?revoke=true \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'
```


## 204 No Content

```json
// empty
```

## URL path and query parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Description</th>
</tr>
</thead>
<tbody>

<tr>
<td>order_id</td>
<td>required</td>
<td>ID of the inactive order to delete.</td>
</tr>
<tr>
<td>revoke</td>
<td>optional</td>
<td>When set to <code>true</code>, revokes the certificate and deletes the order in a single request. <br>Default: <code>false</code>.</td>
</tr>

</tbody>
</table>