Skip to content
Start here

Logs

Get certificate log details
radar.ct.logs.get(strlog_slug, LogGetParams**kwargs) -> LogGetResponse
GET/radar/ct/logs/{log_slug}
List certificate logs
radar.ct.logs.list(LogListParams**kwargs) -> LogListResponse
GET/radar/ct/logs
ModelsExpand Collapse
class LogGetResponse:
certificate_log: CertificateLog
api: Literal["RFC6962", "STATIC"]

The API standard that the certificate log follows.

One of the following:
"RFC6962"
"STATIC"
avg_throughput: float

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

description: str

A brief description of the certificate log.

end_exclusive: datetime

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

formatdate-time
last_update: datetime

Timestamp of the most recent update to the CT log.

formatdate-time
operator: str

The organization responsible for operating the certificate log.

performance: Optional[CertificateLogPerformance]

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

endpoints: List[CertificateLogPerformanceEndpoint]
endpoint: Literal["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"
response_time: float
uptime: float
response_time: float
uptime: float
One of the following:
slug: str

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

start_inclusive: datetime

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

formatdate-time
state: Literal["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"
state_timestamp: datetime

Timestamp of when the log state was last updated.

formatdate-time
submittable_cert_count: Optional[str]

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.

submitted_cert_count: Optional[str]

Number of certificates already included in this CT log.

url: str

The URL for the certificate log.

class LogListResponse:
certificate_logs: List[CertificateLog]
api: Literal["RFC6962", "STATIC"]

The API standard that the certificate log follows.

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

A brief description of the certificate log.

end_exclusive: datetime

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

formatdate-time
operator: str

The organization responsible for operating the certificate log.

slug: str

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

start_inclusive: datetime

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

formatdate-time
state: Literal["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"
state_timestamp: datetime

Timestamp of when the log state was last updated.

formatdate-time
url: str

The URL for the certificate log.