--- title: List Certificate Packs --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [SSL](https://developers.cloudflare.com/api/go/resources/ssl) [Certificate Packs](https://developers.cloudflare.com/api/go/resources/ssl/subresources/certificate_packs) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Certificate Packs client.SSL.CertificatePacks.List(ctx, params) (\*V4PagePaginationArray\[[CertificatePackListResponse]()], error) 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` ##### ParametersExpand Collapse
params CertificatePackListParams ZoneID param.Field\[string] Path param: Identifier. maxLength32 Link to this property
Deploy param.Field\[CertificatePackListParamsDeploy]Optional Query param: Specify the deployment environment for the certificate packs. const CertificatePackListParamsDeployStaging CertificatePackListParamsDeploy = "staging" Link to this property const CertificatePackListParamsDeployProduction CertificatePackListParamsDeploy = "production" Link to this property
Link to this property Page param.Field\[float64]Optional Query param: Page number of paginated results. minimum1 Link to this property PerPage param.Field\[float64]Optional Query param: Number of certificate packs per page. maximum50 minimum5 Link to this property
Status param.Field\[CertificatePackListParamsStatus]Optional Query param: Include Certificate Packs of all statuses, not just active ones. const CertificatePackListParamsStatusAll CertificatePackListParamsStatus = "all" Link to this property
Link to this property
[Link to this property](<#(resource)%20ssl.certificate_packs%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type CertificatePackListResponse struct{…} A certificate pack with all its properties. ID string The unique identifier for a certificate\_pack. Link to this property
Certificates \[]CertificatePackListResponseCertificate Array of certificates in this pack. ID string Certificate identifier. Link to this property Hosts \[]string Hostnames covered by this certificate. Link to this property Status string Certificate status. Link to this property BundleMethod stringOptional Certificate bundle method. Link to this property ExpiresOn TimeOptional When the certificate from the authority expires. formatdate-time Link to this property
GeoRestrictions CertificatePackListResponseCertificatesGeoRestrictionsOptional Specify the region where your private key can be held locally.
Label CertificatePackListResponseCertificatesGeoRestrictionsLabelOptional One of the following: const CertificatePackListResponseCertificatesGeoRestrictionsLabelUs CertificatePackListResponseCertificatesGeoRestrictionsLabel = "us" Link to this property const CertificatePackListResponseCertificatesGeoRestrictionsLabelEu CertificatePackListResponseCertificatesGeoRestrictionsLabel = "eu" Link to this property const CertificatePackListResponseCertificatesGeoRestrictionsLabelHighestSecurity CertificatePackListResponseCertificatesGeoRestrictionsLabel = "highest\_security" Link to this property
Link to this property
Link to this property Issuer stringOptional The certificate authority that issued the certificate. Link to this property ModifiedOn TimeOptional When the certificate was last modified. formatdate-time Link to this property Priority float64Optional The order/priority in which the certificate will be used. Link to this property Signature stringOptional The type of hash used for the certificate. Link to this property UploadedOn TimeOptional When the certificate was uploaded to Cloudflare. formatdate-time Link to this property ZoneID stringOptional Identifier. maxLength32 Link to this property
Link to this property Hosts \[]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: const StatusInitializing Status = "initializing" Link to this property const StatusPendingValidation Status = "pending\_validation" Link to this property const StatusDeleted Status = "deleted" Link to this property const StatusPendingIssuance Status = "pending\_issuance" Link to this property const StatusPendingDeployment Status = "pending\_deployment" Link to this property const StatusPendingDeletion Status = "pending\_deletion" Link to this property const StatusPendingExpiration Status = "pending\_expiration" Link to this property const StatusExpired Status = "expired" Link to this property const StatusActive Status = "active" Link to this property const StatusInitializingTimedOut Status = "initializing\_timed\_out" Link to this property const StatusValidationTimedOut Status = "validation\_timed\_out" Link to this property const StatusIssuanceTimedOut Status = "issuance\_timed\_out" Link to this property const StatusDeploymentTimedOut Status = "deployment\_timed\_out" Link to this property const StatusDeletionTimedOut Status = "deletion\_timed\_out" Link to this property const StatusPendingCleanup Status = "pending\_cleanup" Link to this property const StatusStagingDeployment Status = "staging\_deployment" Link to this property const StatusStagingActive Status = "staging\_active" Link to this property const StatusDeactivating Status = "deactivating" Link to this property const StatusInactive Status = "inactive" Link to this property const StatusBackupIssued Status = "backup\_issued" Link to this property const StatusHoldingDeployment Status = "holding\_deployment" Link to this property
Link to this property
Type CertificatePackListResponseType Type of certificate pack. One of the following: const CertificatePackListResponseTypeMhCustom CertificatePackListResponseType = "mh\_custom" Link to this property const CertificatePackListResponseTypeManagedHostname CertificatePackListResponseType = "managed\_hostname" Link to this property const CertificatePackListResponseTypeSNICustom CertificatePackListResponseType = "sni\_custom" Link to this property const CertificatePackListResponseTypeUniversal CertificatePackListResponseType = "universal" Link to this property const CertificatePackListResponseTypeAdvanced CertificatePackListResponseType = "advanced" Link to this property const CertificatePackListResponseTypeTotalTLS CertificatePackListResponseType = "total\_tls" Link to this property const CertificatePackListResponseTypeKeyless CertificatePackListResponseType = "keyless" Link to this property const CertificatePackListResponseTypeLegacyCustom CertificatePackListResponseType = "legacy\_custom" Link to this property
Link to this property
CertificateAuthority CertificatePackListResponseCertificateAuthorityOptional 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: const CertificatePackListResponseCertificateAuthorityGoogle CertificatePackListResponseCertificateAuthority = "google" Link to this property const CertificatePackListResponseCertificateAuthorityLetsEncrypt CertificatePackListResponseCertificateAuthority = "lets\_encrypt" Link to this property const CertificatePackListResponseCertificateAuthoritySSLCom CertificatePackListResponseCertificateAuthority = "ssl\_com" Link to this property
Link to this property CloudflareBranding boolOptional 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
DCVDelegationRecords \[]CertificatePackListResponseDCVDelegationRecordOptional DCV Delegation records for domain validation. CNAME stringOptional The CNAME record hostname for DCV delegation. Link to this property CNAMETarget stringOptional The CNAME record target value for DCV delegation. Link to this property Emails \[]stringOptional The set of email addresses that the certificate authority (CA) will use to complete domain validation. Link to this property HTTPBody stringOptional The content that the certificate authority (CA) will expect to find at the http\_url during the domain validation. Link to this property HTTPURL stringOptional The url that will be checked during domain validation. Link to this property Status stringOptional Status of the validation record. Link to this property TXTName stringOptional The hostname that the certificate authority (CA) will check for a TXT record during domain validation . Link to this property TXTValue stringOptional The TXT record that the certificate authority (CA) will check during domain validation. Link to this property
Link to this property PrimaryCertificate stringOptional Identifier of the primary certificate in a pack. Link to this property
ValidationErrors \[]CertificatePackListResponseValidationErrorOptional Domain validation errors that have been received by the certificate authority (CA). Message stringOptional A domain validation error. Link to this property
Link to this property
ValidationMethod CertificatePackListResponseValidationMethodOptional Validation Method selected for the order. One of the following: const CertificatePackListResponseValidationMethodTXT CertificatePackListResponseValidationMethod = "txt" Link to this property const CertificatePackListResponseValidationMethodHTTP CertificatePackListResponseValidationMethod = "http" Link to this property const CertificatePackListResponseValidationMethodEmail CertificatePackListResponseValidationMethod = "email" Link to this property
Link to this property
ValidationRecords \[]CertificatePackListResponseValidationRecordOptional Certificates’ validation records. CNAME stringOptional The CNAME record hostname for DCV delegation. Link to this property CNAMETarget stringOptional The CNAME record target value for DCV delegation. Link to this property Emails \[]stringOptional The set of email addresses that the certificate authority (CA) will use to complete domain validation. Link to this property HTTPBody stringOptional The content that the certificate authority (CA) will expect to find at the http\_url during the domain validation. Link to this property HTTPURL stringOptional The url that will be checked during domain validation. Link to this property Status stringOptional Status of the validation record. Link to this property TXTName stringOptional The hostname that the certificate authority (CA) will check for a TXT record during domain validation . Link to this property TXTValue stringOptional The TXT record that the certificate authority (CA) will check during domain validation. Link to this property
Link to this property
ValidityDays CertificatePackListResponseValidityDaysOptional Validity Days selected for the order. One of the following: const CertificatePackListResponseValidityDays14 CertificatePackListResponseValidityDays = 14 Link to this property const CertificatePackListResponseValidityDays30 CertificatePackListResponseValidityDays = 30 Link to this property const CertificatePackListResponseValidityDays90 CertificatePackListResponseValidityDays = 90 Link to this property const CertificatePackListResponseValidityDays365 CertificatePackListResponseValidityDays = 365 Link to this property
Link to this property
[Link to this property](<#(resource)%20ssl.certificate_packs%20%3E%20(model)%20CertificatePackListResponse%20%3E%20(schema)>) ### List Certificate Packs Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/ssl" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) page, err := client.SSL.CertificatePacks.List(context.TODO(), ssl.CertificatePackListParams{ ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` 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 } } ```