Revoke certificate


All revocation requests must be approved by an administrator before DigiCert will revoke the certificate. This approval step is required and cannot be skipped.

Use this endpoint to submit a request to revoke a single certificate.

Certificates with a pending reissue order cannot be revoked. To revoke a certificate with a pending reissue, either cancel the reissue request or revoke the certificate after the reissue is complete.

curl -X PUT \
  '{{certificate_id}}/revoke' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
  "comments": "I no longer need this cert."
import requests

url = "{{certificate_id}}/revoke"

payload = "{\n  \"comments\": \"I no longer need this cert.\"\n}"
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"

response = requests.request("PUT", url, data=payload, headers=headers)

package main

import (

func main() {

	url := "{{certificate_id}}/revoke"

	payload := strings.NewReader("{\n  \"comments\": \"I no longer need this cert.\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)


var request = require("request");

var options = { method: 'PUT',
  url: '{{certificate_id}}/revoke',
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: { comments: 'I no longer need this cert.' },
  json: true };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

201 Created
  "id": 1,
  "date": "2016-02-10T17:06:15+00:00",
  "type": "revoke",
  "status": "pending",
  "requester": {
    "id": 14,
    "first_name": "John",
    "last_name": "Smith",
    "email": ""
  "comments": "I no longer need this cert."

Request parameters

Name Req/Opt Type Description
comments optional string Message about the revoke request.

Response parameters

Name Type Description
id int Request ID.
date string Timestamp of when the request was submitted.
Format: UTC timezone and ISO 8601 date
type string Request type.
Possible values: revoke
status string Status of the revoke request.
Possible values: submitted, pending, approved, rejected
requester object Details about the user that placed the request.
See Structures – User details object.
comments string Message about the revoke request.