--- title: List Certificate Packs --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [SSL](https://developers.cloudflare.com/api/resources/ssl) [Certificate Packs](https://developers.cloudflare.com/api/resources/ssl/subresources/certificate_packs) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Certificate Packs GET/zones/{zone\_id}/ssl/certificate\_packs For a given zone, list all active certificate packs. ##### 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` ##### P ath ParametersExpand Collapse zone\_id: string Identifier. maxLength32 [Link to this property](<#(resource)%20ssl.certificate_packs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20zone_id%20%3E%20(schema)>) ##### Q uery ParametersExpand Collapse

deploy: optional "staging"or "production" Specify the deployment environment for the certificate packs.

One of the following: "staging" Link to this property "production" Link to this property

[Link to this property](<#(resource)%20ssl.certificate_packs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20deploy%20%3E%20(schema)>) page: optional number Page number of paginated results. minimum1 [Link to this property](<#(resource)%20ssl.certificate_packs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page%20%3E%20(schema)>) per\_page: optional number Number of certificate packs per page. maximum50 minimum5 [Link to this property](<#(resource)%20ssl.certificate_packs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>) status: optional "all" Include Certificate Packs of all statuses, not just active ones. [Link to this property](<#(resource)%20ssl.certificate_packs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)>) ##### ReturnsExpand Collapse

errors: array of object {code, message, documentation\_url, source }

code: number minimum1000 Link to this property message: string Link to this property documentation\_url: optional string Link to this property

source: optional object {pointer }

pointer: optional string Link to this property

Link to this property

[Link to this property](<#(resource)%20ssl.certificate_packs%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)

messages: array of object {code, message, documentation\_url, source }

code: number minimum1000 Link to this property message: string Link to this property documentation\_url: optional string Link to this property

source: optional object {pointer }

pointer: optional string Link to this property

Link to this property

[Link to this property](<#(resource)%20ssl.certificate_packs%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20messages>) success: true Whether the API call was successful. [Link to this property](<#(resource)%20ssl.certificate_packs%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20success>)

result: optional array of object {id, certificates, hosts, 10 more }

id: string The unique identifier for a certificate\_pack. Link to this property

certificates: array of object {id, hosts, status, 9 more } Array of certificates in this pack.

id: string Certificate identifier. Link to this property hosts: array of string Hostnames covered by this certificate. Link to this property status: string Certificate status. Link to this property bundle\_method: optional string Certificate bundle method. Link to this property expires\_on: optional string When the certificate from the authority expires. formatdate-time Link to this property

geo\_restrictions: optional object {label } Specify the region where your private key can be held locally.

label: optional "us"or "eu"or "highest\_security"

One of the following: "us" Link to this property "eu" Link to this property "highest\_security" Link to this property

Link to this property

Link to this property issuer: optional string The certificate authority that issued the certificate. Link to this property modified\_on: optional string When the certificate was last modified. formatdate-time Link to this property priority: optional number The order/priority in which the certificate will be used. Link to this property signature: optional string The type of hash used for the certificate. Link to this property uploaded\_on: optional string When the certificate was uploaded to Cloudflare. formatdate-time Link to this property zone\_id: optional string Identifier. maxLength32 Link to this property

Link to this property hosts: array of Host Comma separated list of valid host names for the certificate packs. Must contain the zone apex, may not contain more than 50 hosts, and may not be empty. Link to this property

status: Status Status of certificate pack.

One of the following: "initializing" Link to this property "pending\_validation" Link to this property "deleted" Link to this property "pending\_issuance" Link to this property "pending\_deployment" Link to this property "pending\_deletion" Link to this property "pending\_expiration" Link to this property "expired" Link to this property "active" Link to this property "initializing\_timed\_out" Link to this property "validation\_timed\_out" Link to this property "issuance\_timed\_out" Link to this property "deployment\_timed\_out" Link to this property "deletion\_timed\_out" Link to this property "pending\_cleanup" Link to this property "staging\_deployment" Link to this property "staging\_active" Link to this property "deactivating" Link to this property "inactive" Link to this property "backup\_issued" Link to this property "holding\_deployment" Link to this property

Link to this property

type: "mh\_custom"or "managed\_hostname"or "sni\_custom"or 5 more Type of certificate pack.

One of the following: "mh\_custom" Link to this property "managed\_hostname" Link to this property "sni\_custom" Link to this property "universal" Link to this property "advanced" Link to this property "total\_tls" Link to this property "keyless" Link to this property "legacy\_custom" Link to this property

Link to this property

certificate\_authority: optional "google"or "lets\_encrypt"or "ssl\_com" Certificate Authority selected for the order. For information on any certificate authority specific details or restrictions see this page for more details.

One of the following: "google" Link to this property "lets\_encrypt" Link to this property "ssl\_com" Link to this property

Link to this property cloudflare\_branding: optional boolean Whether or not to add Cloudflare Branding for the order. This will add a subdomain of sni.cloudflaressl.com as the Common Name if set to true. Link to this property

dcv\_delegation\_records: optional array of object {cname, cname\_target, emails, 5 more } DCV Delegation records for domain validation.

cname: optional string The CNAME record hostname for DCV delegation. Link to this property cname\_target: optional string The CNAME record target value for DCV delegation. Link to this property emails: optional array of string The set of email addresses that the certificate authority (CA) will use to complete domain validation. Link to this property http\_body: optional string The content that the certificate authority (CA) will expect to find at the http\_url during the domain validation. Link to this property http\_url: optional string The url that will be checked during domain validation. Link to this property status: optional string Status of the validation record. Link to this property txt\_name: optional string The hostname that the certificate authority (CA) will check for a TXT record during domain validation . Link to this property txt\_value: optional string The TXT record that the certificate authority (CA) will check during domain validation. Link to this property

Link to this property primary\_certificate: optional string Identifier of the primary certificate in a pack. Link to this property

validation\_errors: optional array of object {message } Domain validation errors that have been received by the certificate authority (CA).

message: optional string A domain validation error. Link to this property

Link to this property

validation\_method: optional "txt"or "http"or "email" Validation Method selected for the order.

One of the following: "txt" Link to this property "http" Link to this property "email" Link to this property

Link to this property

validation\_records: optional array of object {cname, cname\_target, emails, 5 more } Certificates’ validation records.

Link to this property

validity\_days: optional 14or 30or 90or 365 Validity Days selected for the order.

One of the following: 14 Link to this property 30 Link to this property 90 Link to this property 365 Link to this property

Link to this property

[Link to this property](<#(resource)%20ssl.certificate_packs%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result>)

result\_info: optional object {count, page, per\_page, 2 more }

count: optional number Total number of results for the requested service. Link to this property page: optional number Current page within paginated list of results. Link to this property per\_page: optional number Number of results per page of results. Link to this property total\_count: optional number Total results available without any search parameters. Link to this property total\_pages: optional number The number of total pages in the entire result set. Link to this property

[Link to this property](<#(resource)%20ssl.certificate_packs%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>) ### List Certificate Packs HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/zones/$ZONE_ID/ssl/certificate_packs \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` 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": "3822ff90-ea29-44df-9e55-21300bb9419b", "certificates": [ { "id": "7e7b8deba8538af625850b7b2530034c", "hosts": [ "example.com", "*.example.com" ], "status": "active", "bundle_method": "ubiquitous", "expires_on": "2024-01-01T00:00:00Z", "geo_restrictions": { "label": "us" }, "issuer": "Let's Encrypt", "modified_on": "2014-01-01T05:20:00Z", "priority": 0, "signature": "ECDSAWithSHA256", "uploaded_on": "2014-01-01T05:20:00Z", "zone_id": "023e105f4ecef8ad9ca31a8372d0c353" } ], "hosts": [ "example.com", "*.example.com", "www.example.com" ], "status": "initializing", "type": "universal", "certificate_authority": "lets_encrypt", "cloudflare_branding": false, "dcv_delegation_records": [ { "cname": "_acme-challenge.example.com", "cname_target": "dcv.cloudflare.com", "emails": [ "administrator@example.com", "webmaster@example.com" ], "http_body": "ca3-574923932a82475cb8592200f1a2a23d", "http_url": "http://app.example.com/.well-known/pki-validation/ca3-da12a1c25e7b48cf80408c6c1763b8a2.txt", "status": "pending", "txt_name": "_acme-challenge.app.example.com", "txt_value": "810b7d5f01154524b961ba0cd578acc2" } ], "primary_certificate": "7e7b8deba8538af625850b7b2530034c", "validation_errors": [ { "message": "SERVFAIL looking up CAA for app.example.com" } ], "validation_method": "txt", "validation_records": [ { "cname": "_acme-challenge.example.com", "cname_target": "dcv.cloudflare.com", "emails": [ "administrator@example.com", "webmaster@example.com" ], "http_body": "ca3-574923932a82475cb8592200f1a2a23d", "http_url": "http://app.example.com/.well-known/pki-validation/ca3-da12a1c25e7b48cf80408c6c1763b8a2.txt", "status": "pending", "txt_name": "_acme-challenge.app.example.com", "txt_value": "810b7d5f01154524b961ba0cd578acc2" } ], "validity_days": 14 } ], "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 100 } } ``` ##### 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": "3822ff90-ea29-44df-9e55-21300bb9419b", "certificates": [ { "id": "7e7b8deba8538af625850b7b2530034c", "hosts": [ "example.com", "*.example.com" ], "status": "active", "bundle_method": "ubiquitous", "expires_on": "2024-01-01T00:00:00Z", "geo_restrictions": { "label": "us" }, "issuer": "Let's Encrypt", "modified_on": "2014-01-01T05:20:00Z", "priority": 0, "signature": "ECDSAWithSHA256", "uploaded_on": "2014-01-01T05:20:00Z", "zone_id": "023e105f4ecef8ad9ca31a8372d0c353" } ], "hosts": [ "example.com", "*.example.com", "www.example.com" ], "status": "initializing", "type": "universal", "certificate_authority": "lets_encrypt", "cloudflare_branding": false, "dcv_delegation_records": [ { "cname": "_acme-challenge.example.com", "cname_target": "dcv.cloudflare.com", "emails": [ "administrator@example.com", "webmaster@example.com" ], "http_body": "ca3-574923932a82475cb8592200f1a2a23d", "http_url": "http://app.example.com/.well-known/pki-validation/ca3-da12a1c25e7b48cf80408c6c1763b8a2.txt", "status": "pending", "txt_name": "_acme-challenge.app.example.com", "txt_value": "810b7d5f01154524b961ba0cd578acc2" } ], "primary_certificate": "7e7b8deba8538af625850b7b2530034c", "validation_errors": [ { "message": "SERVFAIL looking up CAA for app.example.com" } ], "validation_method": "txt", "validation_records": [ { "cname": "_acme-challenge.example.com", "cname_target": "dcv.cloudflare.com", "emails": [ "administrator@example.com", "webmaster@example.com" ], "http_body": "ca3-574923932a82475cb8592200f1a2a23d", "http_url": "http://app.example.com/.well-known/pki-validation/ca3-da12a1c25e7b48cf80408c6c1763b8a2.txt", "status": "pending", "txt_name": "_acme-challenge.app.example.com", "txt_value": "810b7d5f01154524b961ba0cd578acc2" } ], "validity_days": 14 } ], "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 100 } } ```