Skip to content
Cloudflare API
Start here
API Reference
Origin TLS Client Auth

Hostname Certificates

List Certificates
origin_tls_client_auth.hostname_certificates.list(HostnameCertificateListParams**kwargs) -> SyncSinglePage[HostnameCertificateListResponse]
GET/zones/{zone_id}/origin_tls_client_auth/hostnames/certificates
Get the Hostname Client Certificate
origin_tls_client_auth.hostname_certificates.get(strcertificate_id, HostnameCertificateGetParams**kwargs) -> HostnameCertificateGetResponse
GET/zones/{zone_id}/origin_tls_client_auth/hostnames/certificates/{certificate_id}
Upload a Hostname Client Certificate
origin_tls_client_auth.hostname_certificates.create(HostnameCertificateCreateParams**kwargs) -> HostnameCertificateCreateResponse
POST/zones/{zone_id}/origin_tls_client_auth/hostnames/certificates
Delete Hostname Client Certificate
origin_tls_client_auth.hostname_certificates.delete(strcertificate_id, HostnameCertificateDeleteParams**kwargs) -> HostnameCertificateDeleteResponse
DELETE/zones/{zone_id}/origin_tls_client_auth/hostnames/certificates/{certificate_id}
ModelsExpand Collapse
class Certificate: …
id: Optional[str]

Identifier.

maxLength32
certificate: Optional[str]

The hostname certificate.

expires_on: Optional[datetime]

The date when the certificate expires.

formatdate-time
issuer: Optional[str]

The certificate authority that issued the certificate.

serial_number: Optional[str]

The serial number on the uploaded certificate.

signature: Optional[str]

The type of hash used for the certificate.

status: Optional[Literal["initializing", "pending_deployment", "pending_deletion", 4 more]]

Status of the certificate or the association.

One of the following:
"initializing"
"pending_deployment"
"pending_deletion"
"active"
"deleted"
"deployment_timed_out"
"deletion_timed_out"
uploaded_on: Optional[datetime]

The time when the certificate was uploaded.

formatdate-time
class HostnameCertificateListResponse: …
id: Optional[str]

Identifier.

maxLength32
certificate: Optional[str]

The hostname certificate.

expires_on: Optional[datetime]

The date when the certificate expires.

formatdate-time
issuer: Optional[str]

The certificate authority that issued the certificate.

serial_number: Optional[str]

The serial number on the uploaded certificate.

signature: Optional[str]

The type of hash used for the certificate.

status: Optional[Literal["initializing", "pending_deployment", "pending_deletion", 4 more]]

Status of the certificate or the association.

One of the following:
"initializing"
"pending_deployment"
"pending_deletion"
"active"
"deleted"
"deployment_timed_out"
"deletion_timed_out"
uploaded_on: Optional[datetime]

The time when the certificate was uploaded.

formatdate-time
class HostnameCertificateGetResponse: …
id: Optional[str]

Identifier.

maxLength32
certificate: Optional[str]

The hostname certificate.

expires_on: Optional[datetime]

The date when the certificate expires.

formatdate-time
issuer: Optional[str]

The certificate authority that issued the certificate.

serial_number: Optional[str]

The serial number on the uploaded certificate.

signature: Optional[str]

The type of hash used for the certificate.

status: Optional[Literal["initializing", "pending_deployment", "pending_deletion", 4 more]]

Status of the certificate or the association.

One of the following:
"initializing"
"pending_deployment"
"pending_deletion"
"active"
"deleted"
"deployment_timed_out"
"deletion_timed_out"
uploaded_on: Optional[datetime]

The time when the certificate was uploaded.

formatdate-time
class HostnameCertificateCreateResponse: …
id: Optional[str]

Identifier.

maxLength32
certificate: Optional[str]

The hostname certificate.

expires_on: Optional[datetime]

The date when the certificate expires.

formatdate-time
issuer: Optional[str]

The certificate authority that issued the certificate.

serial_number: Optional[str]

The serial number on the uploaded certificate.

signature: Optional[str]

The type of hash used for the certificate.

status: Optional[Literal["initializing", "pending_deployment", "pending_deletion", 4 more]]

Status of the certificate or the association.

One of the following:
"initializing"
"pending_deployment"
"pending_deletion"
"active"
"deleted"
"deployment_timed_out"
"deletion_timed_out"
uploaded_on: Optional[datetime]

The time when the certificate was uploaded.

formatdate-time
class HostnameCertificateDeleteResponse: …
id: Optional[str]

Identifier.

maxLength32
certificate: Optional[str]

The hostname certificate.

expires_on: Optional[datetime]

The date when the certificate expires.

formatdate-time
issuer: Optional[str]

The certificate authority that issued the certificate.

serial_number: Optional[str]

The serial number on the uploaded certificate.

signature: Optional[str]

The type of hash used for the certificate.

status: Optional[Literal["initializing", "pending_deployment", "pending_deletion", 4 more]]

Status of the certificate or the association.

One of the following:
"initializing"
"pending_deployment"
"pending_deletion"
"active"
"deleted"
"deployment_timed_out"
"deletion_timed_out"
uploaded_on: Optional[datetime]

The time when the certificate was uploaded.

formatdate-time