--- title: Total TLS Settings Details --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [ACM](https://developers.cloudflare.com/api/go/resources/acm) [Total TLS](https://developers.cloudflare.com/api/go/resources/acm/subresources/total_tls) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Total TLS Settings Details client.ACM.TotalTLS.Get(ctx, query) (\*[TotalTLSGetResponse](), error) GET/zones/{zone\_id}/acm/total\_tls Get Total TLS Settings for a Zone. ##### 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
query TotalTLSGetParams ZoneID param.Field\[string] Identifier. maxLength32 Link to this property
[Link to this property](<#(resource)%20acm.total_tls%20%3E%20(method)%20get%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type TotalTLSGetResponse struct{…}
CertificateAuthority CertificateAuthorityOptional The Certificate Authority that Total TLS certificates will be issued through. One of the following: const CertificateAuthorityGoogle CertificateAuthority = "google" Link to this property const CertificateAuthorityLetsEncrypt CertificateAuthority = "lets\_encrypt" Link to this property const CertificateAuthoritySSLCom CertificateAuthority = "ssl\_com" Link to this property
Link to this property Enabled boolOptional If enabled, Total TLS will order a hostname specific TLS certificate for any proxied A, AAAA, or CNAME record in your zone. Link to this property ValidityPeriod TotalTLSGetResponseValidityPeriodOptional The validity period in days for the certificates ordered via Total TLS. Link to this property
[Link to this property](<#(resource)%20acm.total_tls%20%3E%20(model)%20TotalTLSGetResponse%20%3E%20(schema)>) ### Total TLS Settings Details Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/acm" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) totalTLS, err := client.ACM.TotalTLS.Get(context.TODO(), acm.TotalTLSGetParams{ ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", totalTLS.ValidityPeriod) } ``` 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": { "certificate_authority": "google", "enabled": true, "validity_period": 90 } } ``` ##### 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": { "certificate_authority": "google", "enabled": true, "validity_period": 90 } } ```