Delete an order
2 minute read
https://www.digicert.com/services/v2/order/certificate/{{order_id}}
Use this endpoint to delete an eligible inactive order with the given order ID.
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 endpoint and review the order’s certificate.valid_till date in the API response.
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 revoke query parameter to true.
Example requests and responses
curl -X DELETE \
https://www.digicert.com/services/v2/order/certificate/{{order_id}} \
-H 'Content-Type: application/json' \
-H 'X-DC-DEVKEY: {{api_key}}'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
// empty
URL path and query parameters
| Name | Req/Opt | Description |
|---|---|---|
| order_id | required | ID of the inactive order to delete. |
| revoke | optional | When set to true, revokes the certificate and deletes the order in a single request.Default: false. |