--- title: Client Certificate Details --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Client Certificates](https://developers.cloudflare.com/api/python/resources/client_certificates) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Client Certificate Details client\_certificates.get(strclient\_certificate\_id, ClientCertificateGetParams\*\*kwargs) -> [ClientCertificate]() GET/zones/{zone\_id}/client\_certificates/{client\_certificate\_id} Get Details for a single mTLS API Shield Client Certificate. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `SSL and Certificates Write``SSL and Certificates Read` ##### ParametersExpand Collapse zone\_id: str Identifier. maxLength32 [Link to this property](<#(resource)%20client_certificates%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20zone_id%20%3E%20(schema)>) client\_certificate\_id: str Client Certificate Tag maxLength36 minLength36 [Link to this property](<#(resource)%20client_certificates%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20client_certificate_id%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class ClientCertificate: … id: Optional\[str] Client Certificate Tag maxLength36 minLength36 Link to this property certificate: Optional\[str] The Client Certificate PEM. Link to this property
certificate\_authority: Optional\[CertificateAuthority] Certificate Authority used to issue the Client Certificate. id: Optional\[str] Link to this property name: Optional\[str] Link to this property
Link to this property common\_name: Optional\[str] Common Name of the Client Certificate. Link to this property country: Optional\[str] Country, provided by the CSR. Link to this property csr: Optional\[str] The Certificate Signing Request (CSR). Must be newline-encoded. Link to this property expires\_on: Optional\[str] Date that the Client Certificate expires. Link to this property fingerprint\_sha256: Optional\[str] Unique identifier of the Client Certificate. Link to this property issued\_on: Optional\[str] Date that the Client Certificate was issued by the Certificate Authority. Link to this property location: Optional\[str] Location, provided by the CSR. Link to this property organization: Optional\[str] Organization, provided by the CSR. Link to this property organizational\_unit: Optional\[str] Organizational Unit, provided by the CSR. Link to this property serial\_number: Optional\[str] The serial number on the created Client Certificate. Link to this property signature: Optional\[str] The type of hash used for the Client Certificate.. Link to this property ski: Optional\[str] Subject Key Identifier. Link to this property state: Optional\[str] State, provided by the CSR. Link to this property
status: Optional\[Literal\["active", "pending\_reactivation", "pending\_revocation", "revoked"]] Client Certificates may be active or revoked, and the pending\_reactivation or pending\_revocation represent in-progress asynchronous transitions. One of the following: "active" Link to this property "pending\_reactivation" Link to this property "pending\_revocation" Link to this property "revoked" Link to this property
Link to this property validity\_days: Optional\[int] The number of days the Client Certificate will be valid after the issued\_on date. Link to this property
[Link to this property](<#(resource)%20client_certificates%20%3E%20(model)%20client_certificate%20%3E%20(schema)>) ### Client Certificate Details Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) client_certificate = client.client_certificates.get( client_certificate_id="0d89c70d-ad9f-4843-b99f-6cc0252067e9", zone_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(client_certificate.id) ``` 200 example ``` { "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": { "id": "0d89c70d-ad9f-4843-b99f-6cc0252067e9", "certificate": "-----BEGIN CERTIFICATE-----\nMIIDmDCCAoC...dhDDE\n-----END CERTIFICATE-----", "certificate_authority": { "id": "568b6b74-7b0c-4755-8840-4e3b8c24adeb", "name": "Cloudflare Managed CA for account" }, "common_name": "Cloudflare", "country": "US", "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIICY....\n-----END CERTIFICATE REQUEST-----", "expires_on": "2033-02-20T23:18:00Z", "fingerprint_sha256": "256c24690243359fb8cf139a125bd05ebf1d968b71e4caf330718e9f5c8a89ea", "issued_on": "2023-02-23T23:18:00Z", "location": "Somewhere", "organization": "Organization", "organizational_unit": "Organizational Unit", "serial_number": "3bb94ff144ac567b9f75ad664b6c55f8d5e48182", "signature": "SHA256WithRSA", "ski": "8e375af1389a069a0f921f8cc8e1eb12d784b949", "state": "CA", "status": "active", "validity_days": 3650 } } ``` ##### Returns Examples 200 example ``` { "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": { "id": "0d89c70d-ad9f-4843-b99f-6cc0252067e9", "certificate": "-----BEGIN CERTIFICATE-----\nMIIDmDCCAoC...dhDDE\n-----END CERTIFICATE-----", "certificate_authority": { "id": "568b6b74-7b0c-4755-8840-4e3b8c24adeb", "name": "Cloudflare Managed CA for account" }, "common_name": "Cloudflare", "country": "US", "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIICY....\n-----END CERTIFICATE REQUEST-----", "expires_on": "2033-02-20T23:18:00Z", "fingerprint_sha256": "256c24690243359fb8cf139a125bd05ebf1d968b71e4caf330718e9f5c8a89ea", "issued_on": "2023-02-23T23:18:00Z", "location": "Somewhere", "organization": "Organization", "organizational_unit": "Organizational Unit", "serial_number": "3bb94ff144ac567b9f75ad664b6c55f8d5e48182", "signature": "SHA256WithRSA", "ski": "8e375af1389a069a0f921f8cc8e1eb12d784b949", "state": "CA", "status": "active", "validity_days": 3650 } } ```