1. Introduction
  2. Order Management
  3. Sample Code
  4. Errors and Troubleshooting
  5. Appendix
  6. Print-Friendly Documentation

Order Management - Retrieve an Issued Certificate

Once a certificate has been issued, it can be retrieved through the API by making a GET request to the certificate endpoint. The API will return the certificate, the intermediate certificate, the root certificate, and the certificates in PKCS7. If the certificate has not yet been issued you will get an error code of cert_unavailable_processing.

This endpoint will return an Etag header that can be used on subsequent calls. If nothing has changed, a 304 response will be returned.

Request Endpoint

MethodURL
GEThttps://api.digicert.com/order/{order_id}/certificate

Response

Parameter NameData TypeDescription
order_id[integer]Unique identifier for certificate order.
serial[string]The serial Number of the Certificate
certs[set] A data set containing the certificates
certificate[string]The certificate
intermediate[string]The intermediate certificate
root[string]The root certificate
pkcs7[string]PKCS7 of the certificates

Sample Request

Endpoint

https://api.digicert.com/order/222307/certificate

Headers

Accept: application/vnd.digicert.rest-v1+json
Authorization: Basic MDAxMDA3OnNreWZhbGw=
User-Agent: MyAPIConsumer/0.42

Body

None

Sample Response

Note that with this sample request, it would return JSON. Including XML for comparison.

Status Code: 200

Headers

Content-Length: 429
Content-Type: application/vnd.digicert.rest-v1+json
Etag: "eac8e208119b9d690be0e2c6981f3c5e"

Body

JSON (application/vnd.digicert.rest-v1+json)XML (application/vnd.digicert.rest-v1+xml)
{
  "order_id":"00276176",
  "serial":"07C2EDE40FEEA2AA03C0615F32D3A26D",
  "certs":{
    "certificate":"-----BEGIN CERTIFICATE-----\n[CERT HERE]\n-----END CERTIFICATE-----\n",
    "intermediate":"-----BEGIN CERTIFICATE----\n[CERT HERE]\n-----END CERTIFICATE-----\n",
    "root":"-----BEGIN CERTIFICATE-----\n[CERT HERE]\n-----END CERTIFICATE-----\n",
    "pkcs7":"-----BEGIN PKCS7-----\n[CERT HERE]\n-----END PKCS7-----\n"
  }
}
<response>
  <order_id>00276176</order_id>
  <serial>07C2EDE40FEEA2AA03C0615F32D3A26D</serial>
  <certs>
    <certificate>
       -----BEGIN CERTIFICATE-----
MIIFMDCCBBigAwIBAgIQB8Lt5A/uoqoDwGFfMtOibTANBgkqhkiG9w0BAQUFADBu
MRMwEQYKCZImiZPyLGQBGRYDY29tMR0wGwYKCZImiZPyLGQBGRYNRGlnaUNlcnQt
[...]+KBK5AAZ7S8N4t3xL4Xgd8Z5QTIwlCj4iYETgC+e6ypRx1EnwkwPTM+v/a3qBAh8
gErk3blCmLLK4ToULBp7R4/fZlyl4htejyDULMSLexKdA+AJ
-----END CERTIFICATE-----
    </certificate>
    <intermediate>
        -----BEGIN CERTIFICATE----
MIIE4zCCA8ugAwIBAgIQByZq8O6u1HhZsthDZLeKTTANBgkqhkiG9w0BAQUFADBx
MRMwEQYKCZImiZPyLGQBGRYDY29tMR0wGwYKCZImiZPyLGQBGRYNRGlnaUNlcnQt
[...]MdK3Empl2nll0vkxKKckM/6g1/zotmUC/L+rCw+75nlYYDN4EhN+2hqN0H7ekiMI
BuUMrn/zOOCE/T51TFmQmVKYhw8mnF6HTeoNqSxiHYsQGDQodFA9847E7puXKWC7
v2w7v6F5aA==
-----END CERTIFICATE-----
    </intermediate>
    <root>
       -----BEGIN CERTIFICATE-----
MIIDzzCCAregAwIBAgIQAblXTWj/ZrPV05Rb6HjP2TANBgkqhkiG9w0BAQUFADBx
MRMwEQYKCZImiZPyLGQBGRYDY29tMR0wGwYKCZImiZPyLGQBGRYNRGlnaUNlcnQt
[...]ijD+28PMnpMH6xOUsJHxpviYGF1Ph2aZvuILgnMGMqAwGp/bdJrHSoyta7CMhNuX
Wg3SKbaUKKz/uA3rMEHFAJ9C4w==
-----END CERTIFICATE-----
    </root>
    <pkcs7>
        -----BEGIN PKCS7-----
MIIOGQYJKoZIhvcNAQcCoIIOCjCCDgYCAQExADALBgkqhkiG9w0BBwGggg3uMIIF
MDCCBBigAwIBAgIQB8Lt5A/uoqoDwGFfMtOibTANBgkqhkiG9w0BAQUFADBuMRMw
[...]ik9Be/i+DFEZQMy7ZfHGEtUx7BuYoNN88eWJfHg5QvbyVd7LwS3LYoow/tvDzJ6T
B+sTlLCR8ab4mBhdT4dmmb7iC4JzBjKgMBqf23Sax0qMrWuwjITbl1oN0im2lCis
/7gN6zBBxQCfQuMxAA==
-----END PKCS7-----
    </pkcs7>
  </certs>
</response>