Skip to content
Cloudflare API
Start here
API Reference
Radar
CT

Logs

Get certificate log details
client.radar.ct.logs.get(stringlogSlug, LogGetParams { format } query?, RequestOptionsoptions?): LogGetResponse { certificateLog }
GET/radar/ct/logs/{log_slug}
List certificate logs
client.radar.ct.logs.list(LogListParams { format, limit, offset } query?, RequestOptionsoptions?): LogListResponse { certificateLogs }
GET/radar/ct/logs
ModelsExpand Collapse
LogGetResponse { certificateLog }
certificateLog: CertificateLog { api, avgThroughput, description, 12 more }
api: "RFC6962" | "STATIC"

The API standard that the certificate log follows.

One of the following:
"RFC6962"
"STATIC"
avgThroughput: number

The average throughput of the CT log, measured in certificates per hour (certs/hour).

description: string

A brief description of the certificate log.

endExclusive: string

The end date and time for when the log will stop accepting certificates.

formatdate-time
lastUpdate: string

Timestamp of the most recent update to the CT log.

formatdate-time
operator: string

The organization responsible for operating the certificate log.

performance: Performance | null

Log performance metrics, including averages and per-endpoint details.

endpoints: Array<Endpoint>
endpoint: "add-chain (new)" | "add-chain (old)" | "add-pre-chain (new)" | 4 more

The certificate log endpoint names used in performance metrics.

One of the following:
"add-chain (new)"
"add-chain (old)"
"add-pre-chain (new)"
"add-pre-chain (old)"
"get-entries"
"get-roots"
"get-sth"
responseTime: number
uptime: number
responseTime: number
uptime: number
One of the following:
slug: string

A URL-friendly, kebab-case identifier for the certificate log.

startInclusive: string

The start date and time for when the log starts accepting certificates.

formatdate-time
state: "USABLE" | "PENDING" | "QUALIFIED" | 3 more

The current state of the certificate log. More details about log states can be found here: https://googlechrome.github.io/CertificateTransparency/log_states.html

One of the following:
"USABLE"
"PENDING"
"QUALIFIED"
"READ_ONLY"
"RETIRED"
"REJECTED"
stateTimestamp: string

Timestamp of when the log state was last updated.

formatdate-time
submittableCertCount: string | null

Number of certificates that are eligible for inclusion to this log but have not been included yet. Based on certificates signed by trusted root CAs within the log’s accepted date range.

submittedCertCount: string | null

Number of certificates already included in this CT log.

url: string

The URL for the certificate log.

LogListResponse { certificateLogs }
certificateLogs: Array<CertificateLog>
api: "RFC6962" | "STATIC"

The API standard that the certificate log follows.

One of the following:
"RFC6962"
"STATIC"
description: string

A brief description of the certificate log.

endExclusive: string

The end date and time for when the log will stop accepting certificates.

formatdate-time
operator: string

The organization responsible for operating the certificate log.

slug: string

A URL-friendly, kebab-case identifier for the certificate log.

startInclusive: string

The start date and time for when the log starts accepting certificates.

formatdate-time
state: "USABLE" | "PENDING" | "QUALIFIED" | 3 more

The current state of the certificate log. More details about log states can be found here: https://googlechrome.github.io/CertificateTransparency/log_states.html

One of the following:
"USABLE"
"PENDING"
"QUALIFIED"
"READ_ONLY"
"RETIRED"
"REJECTED"
stateTimestamp: string

Timestamp of when the log state was last updated.

formatdate-time
url: string

The URL for the certificate log.