Skip to main content

Get CT logs (order ID)

GET https://www.digicert.com/services/v2/ctmonitor/{{order_id}}/details?offset=0&limit=1000

Use this endpoint to get the CT logs for the domains on a Secure Site Pro certificate using the certificate's order ID.

Example requests and response

Filters and URL query parameters

This endpoint supports filters, sorting, and pagination. For general information and examples of the syntax to use when applying filters and sorting results, see Services API - Filters, sorting, and pagination parameters.

Example:

https://www.digicert.com/services/v2/ctmonitor/{{order_id}}/details?filters[cn_san_search]=&filters[issuer_ca]={{name of certificate authority}}&filters[precert]=false&sort=-notbefore&offset=0&limit=1000

Name

Req/Opt

Type

Description

filters[{{property_name}}]

optional

string

Filters results by the specified property. Replace {{property_name}} in your request with the property to use for filtering. This endpoint supports filtering by the following properties:

  • filters[issuer_ca]: Use DigiCert, Non-DigiCert (includes all other certificate brands), or {{specific brand name}} (for example, Let's Encrypt).

  • filters[cn_san_search]: Common name or subject alternative name (SAN) to search for (partial or full).

  • filters[precert]: Use true for precertificates or false for certificates.

sort

optional

string

Sorts results by the value of one or more properties. By default, sorts results in ascending alphabetical order (0-9, A-Z). To sort in descending alphabetical order (9-0, Z-A), prefix the property name with a minus (-). To sort by multiple properties, separate the name of each property with a comma. Sort hierarchy matches the order of properties in this list. This endpoint supports sorting by the following properties:

  • notbefore

  • notafter

  • untrusted_ica

  • pem_cn

offset

optional

int

Index of the first result to include in the response.

Default: 0

limit

optional

int

Total number of results to include in the response.

Max: 1000

Response parameters

Name

Type

Description

ct_certificates

array

Details about the certificate.

.. serial

string

Serial number assigned to the certificate on issuance.

.. ctlogs

array

Details from CT logs.

.. .. logged_on

string

Timestamp of when the certificate was logged to CT log.

Format: UTC timezone and ISO 8601 date.

.. .. entry_no

string

Reference ID of CT log from the CT log server.

.. . log_name

string

Name of the CT log server.

.. .. operated_by

string

Owner of CT log server.

.. .. log_url

string

URL of CT log server.

.. digicert_issued

bool

If the certificate was issued by DigiCert.

Possible values:

  • true: issued by DigiCert

  • false: issued by another certificate authority

.. not_after

string

Timestamp of when certificate validity ends.

Format: UTC timezone and ISO 8601 date.

.. not_before

string

Timestamp of when certificate validity begins.

Format: UTC timezone and ISO 8601 date.

.. subject

string

Name secured by the certificate.

.. issuer

string

Name of certificate authority that issued the certificate.

.. precert

bool

Is the certificate in the CT log a precertificate.

Possible values:

  • true: precertificate

  • false: certificate

Only returned if the precert request filter is used.

.. issuer_ca

string

Brand name of issuing certificate authority. Only returned if the issuer_ca request filter is used.

.. trusted_ica

bool

If the issuing certificate authority (ICA) is DigiCert or is whitelisted.

Possible values:

  • true: DigiCert/whitelisted ICA

  • false: untrusted ICA

.. key_algorithm

string

Type of encryption algorithm (e.g., RSA)

.. key_length

string

Number of bits used in the key.

.. self_signed

bool

If the certificate is self-signed.

Possible values:

  • true: self-signed

  • false: not self-signed

.. signature_algorithm

string

Signing algorithm used by the certificate.

.. cert_type

string

Type of certificate.

Possible values:

  • EV

  • OV

  • DV

.. wildcard

bool

If the certificate is a wildcard certificate.

Possible values:

  • true: wildcard certificate

  • false: not a wildcard certificate

.. hosts

object

List of common name or subject alternative names in the order and not in the order Only returned if the ca_san_search request filter is used.

.. .. hosts_in_order

array

Common name or subject alternative names in the certificate order

.. .. host_not_in_order

array

Common name or subject alternative names not in the certificate order

page

object

Details about results. Modified using URL query strings.

.. total

int

Total number of records.

.. limit

int

Pagination record limit

.. offset

int

Pagination starting point

Issuer_ca_list

array

List of issuing certificate authorities (ICAs)

.. General

object

DigiCert and Non-DigiCert

.. Specified CAs

object

List of other certificate authorities present for the account.