REST API Get CA Certificate

Get CA Certificate GET

To retrieve information about a specific CA certificate using the ZeroSSL API, make an HTTPS GET request to the ca_certificates endpoint and pass the certificate identifier in the {identifier} URL parameter. The identifier can be either a numeric CA certificate ID or a SHA-1 hash.

API Request URL:

api.zerossl.com/ca_certificates/{identifier}?access_key=...

GET Request Parameters:

Parameter Description
access_key [Required] Use this parameter to specify your API access key.
{identifier} [Required] Use this parameter to specify the CA certificate identifier. Accepts either the numeric CA certificate ID or the SHA-1 hash of the certificate.

API Response:

If your API request has been successful, you will receive a JSON API response containing all the details of the CA certificate.

{
    "id": 1,
    "hash_sha1": "a3983a3b4e7d5f6c2b1e9d0f8a7c6b5d4e3f2a1b",
    "certificate_intermediate": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
    "bundle_full": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
    "encryption_algorithm": "RSA",
    "official": true,
    "created": "2024-01-15 08:00:00",
    "updated": "2024-01-15 08:00:00"
}

Response Objects:

Parameter Description
id Returns the numeric ID of the CA certificate.
hash_sha1 Returns the SHA-1 hash (fingerprint) of the CA certificate.
certificate_intermediate Returns the CA certificate in PEM format.
bundle_full Returns the CA certificate bundle in PEM format.
encryption_algorithm Returns the encryption algorithm used by the CA certificate (e.g. RSA, ECC).
official Possible values:

null: Not yet decided. This CA Certificate has not yet been investigated, if you have it in your certificate chain probably everything is good, it will be confirmed soon.

true: That is an official ZeroSSL CA certificate which has been checked and confirmed.

false: That is not an official ZeroSSL CA certificate. It is for testing purposes, special use cases, or has been introduced by accident. If you have that certificate in your chain unexpectedly we recommend not to use it in production, instead please contact our support team.
created Returns the exact time (UTC) the CA certificate was created.
updated Returns the exact time (UTC) the CA certificate was updated.