## Get the Hostname Status for Client Authentication `origin_tls_client_auth.hostnames.get(strhostname, HostnameGetParams**kwargs) -> AuthenticatedOriginPull` **get** `/zones/{zone_id}/origin_tls_client_auth/hostnames/{hostname}` Retrieves the client certificate authentication status for a specific hostname, showing whether authenticated origin pulls are enabled. ### Parameters - `zone_id: str` Identifier. - `hostname: str` The hostname on the origin for which the client certificate uploaded will be used. ### Returns - `class AuthenticatedOriginPull: …` - `cert_id: Optional[str]` Identifier. - `cert_status: Optional[Literal["initializing", "pending_deployment", "pending_deletion", 4 more]]` Status of the certificate or the association. - `"initializing"` - `"pending_deployment"` - `"pending_deletion"` - `"active"` - `"deleted"` - `"deployment_timed_out"` - `"deletion_timed_out"` - `cert_updated_at: Optional[datetime]` The time when the certificate was updated. - `cert_uploaded_on: Optional[datetime]` The time when the certificate was uploaded. - `certificate: Optional[str]` The hostname certificate. - `created_at: Optional[datetime]` The time when the certificate was created. - `enabled: Optional[bool]` Indicates whether hostname-level authenticated origin pulls is enabled. A null value voids the association. - `expires_on: Optional[datetime]` The date when the certificate expires. - `hostname: Optional[str]` The hostname on the origin for which the client certificate uploaded will be used. - `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. - `"initializing"` - `"pending_deployment"` - `"pending_deletion"` - `"active"` - `"deleted"` - `"deployment_timed_out"` - `"deletion_timed_out"` - `updated_at: Optional[datetime]` The time when the certificate was updated. ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) authenticated_origin_pull = client.origin_tls_client_auth.hostnames.get( hostname="app.example.com", zone_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(authenticated_origin_pull.cert_id) ``` #### Response ```json { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "cert_id": "023e105f4ecef8ad9ca31a8372d0c353", "cert_status": "active", "cert_updated_at": "2100-01-01T05:20:00Z", "cert_uploaded_on": "2019-10-28T18:11:23.37411Z", "certificate": "-----BEGIN CERTIFICATE-----\nMIIDtTCCAp2gAwIBAgIJAMHAwfXZ5/PWMA0GCSqGSIb3DQEBCwUAMEUxCzAJBgNV\nBAYTAkFVMRMwEQYDVQQIEwpTb21lLVN0YXRlMSEwHwYDVQQKExhJbnRlcm5ldCBX\naWRnaXRzIFB0eSBMdGQwHhcNMTYwODI0MTY0MzAxWhcNMTYxMTIyMTY0MzAxWjBF\nMQswCQYDVQQGEwJBVTETMBEGA1UECBMKU29tZS1TdGF0ZTEhMB8GA1UEChMYSW50\nZXJuZXQgV2lkZ2l0cyBQdHkgTHRkMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB\nCgKCAQEAwQHoetcl9+5ikGzV6cMzWtWPJHqXT3wpbEkRU9Yz7lgvddmGdtcGbg/1\nCGZu0jJGkMoppoUo4c3dts3iwqRYmBikUP77wwY2QGmDZw2FvkJCJlKnabIRuGvB\nKwzESIXgKk2016aTP6/dAjEHyo6SeoK8lkIySUvK0fyOVlsiEsCmOpidtnKX/a+5\n0GjB79CJH4ER2lLVZnhePFR/zUOyPxZQQ4naHf7yu/b5jhO0f8fwt+pyFxIXjbEI\ndZliWRkRMtzrHOJIhrmJ2A1J7iOrirbbwillwjjNVUWPf3IJ3M12S9pEewooaeO2\nizNTERcG9HzAacbVRn2Y2SWIyT/18QIDAQABo4GnMIGkMB0GA1UdDgQWBBT/LbE4\n9rWf288N6sJA5BRb6FJIGDB1BgNVHSMEbjBsgBT/LbE49rWf288N6sJA5BRb6FJI\nGKFJpEcwRTELMAkGA1UEBhMCQVUxEzARBgNVBAgTClNvbWUtU3RhdGUxITAfBgNV\nBAoTGEludGVybmV0IFdpZGdpdHMgUHR5IEx0ZIIJAMHAwfXZ5/PWMAwGA1UdEwQF\nMAMBAf8wDQYJKoZIhvcNAQELBQADggEBAHHFwl0tH0quUYZYO0dZYt4R7SJ0pCm2\n2satiyzHl4OnXcHDpekAo7/a09c6Lz6AU83cKy/+x3/djYHXWba7HpEu0dR3ugQP\nMlr4zrhd9xKZ0KZKiYmtJH+ak4OM4L3FbT0owUZPyjLSlhMtJVcoRp5CJsjAMBUG\nSvD8RX+T01wzox/Qb+lnnNnOlaWpqu8eoOenybxKp1a9ULzIVvN/LAcc+14vioFq\n2swRWtmocBAs8QR9n4uvbpiYvS8eYueDCWMM4fvFfBhaDZ3N9IbtySh3SpFdQDhw\nYbjM2rxXiyLGxB4Bol7QTv4zHif7Zt89FReT/NBy4rzaskDJY5L6xmY=\n-----END CERTIFICATE-----\n", "created_at": "2100-01-01T05:20:00Z", "enabled": true, "expires_on": "2100-01-01T05:20:00Z", "hostname": "app.example.com", "issuer": "GlobalSign", "serial_number": "6743787633689793699141714808227354901", "signature": "SHA256WithRSA", "status": "active", "updated_at": "2100-01-01T05:20:00Z" } } ```