---
title: Custom Hostname Details
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/go)

[Custom Hostnames](https://developers.cloudflare.com/api/go/resources/custom_hostnames)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Custom Hostname Details

client.CustomHostnames.Get(ctx, customHostnameID, query) (\*[CustomHostnameGetResponse](<https://developers.cloudflare.com/api/go/resources/custom_hostnames#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)>), error)

GET/zones/{zone\_id}/custom\_hostnames/{custom\_hostname\_id}

Retrieves detailed information about a specific custom hostname, including SSL certificate status, ownership verification, and origin configuration.

##### Security

<details>

<summary>API Token</summary>



The preferred authorization scheme for interacting with the Cloudflare API. <a href="https://developers.cloudflare.com/fundamentals/api/get-started/create-token/">Create a token</a>.

**Example:**<code>Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY</code>

</details>

<details>

<summary>API Email + API Key</summary>



The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

**Example:**<code>X-Auth-Email: user@example.com</code>

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

**Example:**<code>X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194</code>

</details>

##### Accepted Permissions (at least one required)

`SSL and Certificates Write``SSL and Certificates Read`

##### ParametersExpand Collapse

customHostnameID string

Custom hostname identifier tag.

maxLength36

minLength36

[Link to this property](<#(resource)%20custom_hostnames%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20custom_hostname_id%20%3E%20(schema)>)

<details>

<summary>

query CustomHostnameGetParams

</summary>

ZoneID param.Field\[string]

Identifier.

maxLength32

<a href="#(resource)%20custom_hostnames%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20zone_id">Link to this property</a>

</details>

[Link to this property](<#(resource)%20custom_hostnames%20%3E%20(method)%20get%20%3E%20(params)%20default>)

##### ReturnsExpand Collapse

<details>

<summary>

type CustomHostnameGetResponse struct{…}

</summary>

ID string

Custom hostname identifier tag.

maxLength36

minLength36

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

Hostname string

The custom hostname that will point to your hostname via CNAME.

maxLength255

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20hostname">Link to this property</a>

CreatedAt TimeOptional

This is the time the hostname was created.

formatdate-time

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20created_at">Link to this property</a>

CustomMetadata map\[string, string]Optional

Unique key/value metadata for this hostname. These are per-hostname (customer) settings.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20custom_metadata">Link to this property</a>

CustomOriginServer stringOptional

a valid hostname that’s been added to your DNS zone as an A, AAAA, or CNAME record.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20custom_origin_server">Link to this property</a>

CustomOriginSNI stringOptional

A hostname that will be sent to your custom origin server as SNI for TLS handshake. This can be a valid subdomain of the zone or custom origin server name or the string ‘:request\_host\_header:’ which will cause the host header in the request to be used as SNI. Not configurable with default/fallback origin server.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20custom_origin_sni">Link to this property</a>

<details>

<summary>

OwnershipVerification CustomHostnameGetResponseOwnershipVerificationOptional

This is a record which can be placed to activate a hostname.

</summary>

Name stringOptional

DNS Name for record.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ownership_verification%20%3E%20(property)%20name">Link to this property</a>

Type CustomHostnameGetResponseOwnershipVerificationTypeOptional

DNS Record type.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ownership_verification%20%3E%20(property)%20type">Link to this property</a>

Value stringOptional

Content for the record.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ownership_verification%20%3E%20(property)%20value">Link to this property</a>

</details>

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ownership_verification">Link to this property</a>

<details>

<summary>

OwnershipVerificationHTTP CustomHostnameGetResponseOwnershipVerificationHTTPOptional

This presents the token to be served by the given http url to activate a hostname.

</summary>

HTTPBody stringOptional

Token to be served.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ownership_verification_http%20%3E%20(property)%20http_body">Link to this property</a>

HTTPURL stringOptional

The HTTP URL that will be checked during custom hostname verification and where the customer should host the token.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ownership_verification_http%20%3E%20(property)%20http_url">Link to this property</a>

</details>

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ownership_verification_http">Link to this property</a>

<details>

<summary>

SSL CustomHostnameGetResponseSSLOptional

</summary>

ID stringOptional

Custom hostname SSL identifier tag.

maxLength36

minLength36

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20id">Link to this property</a>

<details>

<summary>

BundleMethod <a href="https://developers.cloudflare.com/api/go/resources/custom_hostnames#(resource)%20custom_hostnames%20%3E%20(model)%20bundle_method%20%3E%20(schema)">BundleMethod</a>Optional

A ubiquitous bundle has the highest probability of being verified everywhere, even by clients using outdated or unusual trust stores. An optimal bundle uses the shortest chain and newest intermediates. And the force bundle verifies the chain, but does not otherwise modify it.

</summary>

One of the following:

const BundleMethodUbiquitous <a href="https://developers.cloudflare.com/api/go/resources/custom_hostnames#(resource)%20custom_hostnames%20%3E%20(model)%20bundle_method%20%3E%20(schema)">BundleMethod</a> = "ubiquitous"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20bundle_method%20%2B%20(resource)%20custom_hostnames%20%3E%20(model)%20bundle_method%20%3E%20(schema)%20%3E%20(member)%200">Link to this property</a>

const BundleMethodOptimal <a href="https://developers.cloudflare.com/api/go/resources/custom_hostnames#(resource)%20custom_hostnames%20%3E%20(model)%20bundle_method%20%3E%20(schema)">BundleMethod</a> = "optimal"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20bundle_method%20%2B%20(resource)%20custom_hostnames%20%3E%20(model)%20bundle_method%20%3E%20(schema)%20%3E%20(member)%201">Link to this property</a>

const BundleMethodForce <a href="https://developers.cloudflare.com/api/go/resources/custom_hostnames#(resource)%20custom_hostnames%20%3E%20(model)%20bundle_method%20%3E%20(schema)">BundleMethod</a> = "force"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20bundle_method%20%2B%20(resource)%20custom_hostnames%20%3E%20(model)%20bundle_method%20%3E%20(schema)%20%3E%20(member)%202">Link to this property</a>

</details>

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20bundle_method">Link to this property</a>

<details>

<summary>

CertificateAuthority <a href="https://developers.cloudflare.com/api/go/resources/$shared#(resource)%20%24shared%20%3E%20(model)%20certificate_ca%20%3E%20(schema)">CertificateCA</a>Optional

The Certificate Authority that will issue the certificate.

</summary>

One of the following:

const CertificateCADigicert <a href="https://developers.cloudflare.com/api/go/resources/$shared#(resource)%20%24shared%20%3E%20(model)%20certificate_ca%20%3E%20(schema)">CertificateCA</a> = "digicert"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20certificate_authority%20%2B%20(resource)%20%24shared%20%3E%20(model)%20certificate_ca%20%3E%20(schema)%20%3E%20(member)%200">Link to this property</a>

const CertificateCAGoogle <a href="https://developers.cloudflare.com/api/go/resources/$shared#(resource)%20%24shared%20%3E%20(model)%20certificate_ca%20%3E%20(schema)">CertificateCA</a> = "google"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20certificate_authority%20%2B%20(resource)%20%24shared%20%3E%20(model)%20certificate_ca%20%3E%20(schema)%20%3E%20(member)%201">Link to this property</a>

const CertificateCALetsEncrypt <a href="https://developers.cloudflare.com/api/go/resources/$shared#(resource)%20%24shared%20%3E%20(model)%20certificate_ca%20%3E%20(schema)">CertificateCA</a> = "lets\_encrypt"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20certificate_authority%20%2B%20(resource)%20%24shared%20%3E%20(model)%20certificate_ca%20%3E%20(schema)%20%3E%20(member)%202">Link to this property</a>

const CertificateCASSLCom <a href="https://developers.cloudflare.com/api/go/resources/$shared#(resource)%20%24shared%20%3E%20(model)%20certificate_ca%20%3E%20(schema)">CertificateCA</a> = "ssl\_com"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20certificate_authority%20%2B%20(resource)%20%24shared%20%3E%20(model)%20certificate_ca%20%3E%20(schema)%20%3E%20(member)%203">Link to this property</a>

</details>

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20certificate_authority">Link to this property</a>

CustomCertificate stringOptional

If a custom uploaded certificate is used.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20custom_certificate">Link to this property</a>

CustomCsrID stringOptional

The identifier for the Custom CSR that was used.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20custom_csr_id">Link to this property</a>

CustomKey stringOptional

The key for a custom uploaded certificate.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20custom_key">Link to this property</a>

<details>

<summary>

DCVDelegationRecords \[]CustomHostnameGetResponseSsldcvDelegationRecordOptional

DCV Delegation records for domain validation.

</summary>

CNAME stringOptional

The CNAME record hostname for DCV delegation.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20dcv_delegation_records%20%3E%20(items)%20%3E%20(property)%20cname">Link to this property</a>

CNAMETarget stringOptional

The CNAME record target value for DCV delegation.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20dcv_delegation_records%20%3E%20(items)%20%3E%20(property)%20cname_target">Link to this property</a>

Emails \[]stringOptional

The set of email addresses that the certificate authority (CA) will use to complete domain validation.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20dcv_delegation_records%20%3E%20(items)%20%3E%20(property)%20emails">Link to this property</a>

HTTPBody stringOptional

The content that the certificate authority (CA) will expect to find at the http\_url during the domain validation.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20dcv_delegation_records%20%3E%20(items)%20%3E%20(property)%20http_body">Link to this property</a>

HTTPURL stringOptional

The url that will be checked during domain validation.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20dcv_delegation_records%20%3E%20(items)%20%3E%20(property)%20http_url">Link to this property</a>

Status stringOptional

Status of the validation record.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20dcv_delegation_records%20%3E%20(items)%20%3E%20(property)%20status">Link to this property</a>

TXTName stringOptional

The hostname that the certificate authority (CA) will check for a TXT record during domain validation .

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20dcv_delegation_records%20%3E%20(items)%20%3E%20(property)%20txt_name">Link to this property</a>

TXTValue stringOptional

The TXT record that the certificate authority (CA) will check during domain validation.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20dcv_delegation_records%20%3E%20(items)%20%3E%20(property)%20txt_value">Link to this property</a>

</details>

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20dcv_delegation_records">Link to this property</a>

ExpiresOn TimeOptional

The time the custom certificate expires on.

formatdate-time

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20expires_on">Link to this property</a>

Hosts \[]stringOptional

A list of Hostnames on a custom uploaded certificate.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20hosts">Link to this property</a>

Issuer stringOptional

The issuer on a custom uploaded certificate.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20issuer">Link to this property</a>

<details>

<summary>

Method <a href="https://developers.cloudflare.com/api/go/resources/custom_hostnames#(resource)%20custom_hostnames%20%3E%20(model)%20dcv_method%20%3E%20(schema)">DCVMethod</a>Optional

Domain control validation (DCV) method used for this hostname.

</summary>

One of the following:

const DCVMethodHTTP <a href="https://developers.cloudflare.com/api/go/resources/custom_hostnames#(resource)%20custom_hostnames%20%3E%20(model)%20dcv_method%20%3E%20(schema)">DCVMethod</a> = "http"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20method%20%2B%20(resource)%20custom_hostnames%20%3E%20(model)%20dcv_method%20%3E%20(schema)%20%3E%20(member)%200">Link to this property</a>

const DCVMethodTXT <a href="https://developers.cloudflare.com/api/go/resources/custom_hostnames#(resource)%20custom_hostnames%20%3E%20(model)%20dcv_method%20%3E%20(schema)">DCVMethod</a> = "txt"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20method%20%2B%20(resource)%20custom_hostnames%20%3E%20(model)%20dcv_method%20%3E%20(schema)%20%3E%20(member)%201">Link to this property</a>

const DCVMethodEmail <a href="https://developers.cloudflare.com/api/go/resources/custom_hostnames#(resource)%20custom_hostnames%20%3E%20(model)%20dcv_method%20%3E%20(schema)">DCVMethod</a> = "email"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20method%20%2B%20(resource)%20custom_hostnames%20%3E%20(model)%20dcv_method%20%3E%20(schema)%20%3E%20(member)%202">Link to this property</a>

</details>

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20method">Link to this property</a>

SerialNumber stringOptional

The serial number on a custom uploaded certificate.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20serial_number">Link to this property</a>

<details>

<summary>

Settings CustomHostnameGetResponseSSLSettingsOptional

</summary>

Ciphers \[]stringOptional

An allowlist of ciphers for TLS termination. These ciphers must be in the BoringSSL format.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20settings%20%3E%20(property)%20ciphers">Link to this property</a>

<details>

<summary>

EarlyHints CustomHostnameGetResponseSSLSettingsEarlyHintsOptional

Whether or not Early Hints is enabled.

</summary>

One of the following:

const CustomHostnameGetResponseSSLSettingsEarlyHintsOn CustomHostnameGetResponseSSLSettingsEarlyHints = "on"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20settings%20%3E%20(property)%20early_hints%20%3E%20(member)%200">Link to this property</a>

const CustomHostnameGetResponseSSLSettingsEarlyHintsOff CustomHostnameGetResponseSSLSettingsEarlyHints = "off"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20settings%20%3E%20(property)%20early_hints%20%3E%20(member)%201">Link to this property</a>

</details>

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20settings%20%3E%20(property)%20early_hints">Link to this property</a>

<details>

<summary>

HTTP2 CustomHostnameGetResponseSSLSettingsHTTP2Optional

Whether or not HTTP2 is enabled.

</summary>

One of the following:

const CustomHostnameGetResponseSSLSettingsHTTP2On CustomHostnameGetResponseSSLSettingsHTTP2 = "on"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20settings%20%3E%20(property)%20http2%20%3E%20(member)%200">Link to this property</a>

const CustomHostnameGetResponseSSLSettingsHTTP2Off CustomHostnameGetResponseSSLSettingsHTTP2 = "off"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20settings%20%3E%20(property)%20http2%20%3E%20(member)%201">Link to this property</a>

</details>

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20settings%20%3E%20(property)%20http2">Link to this property</a>

<details>

<summary>

MinTLSVersion CustomHostnameGetResponseSSLSettingsMinTLSVersionOptional

The minimum TLS version supported.

</summary>

One of the following:

const CustomHostnameGetResponseSSLSettingsMinTLSVersion1\_0 CustomHostnameGetResponseSSLSettingsMinTLSVersion = "1.0"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20settings%20%3E%20(property)%20min_tls_version%20%3E%20(member)%200">Link to this property</a>

const CustomHostnameGetResponseSSLSettingsMinTLSVersion1\_1 CustomHostnameGetResponseSSLSettingsMinTLSVersion = "1.1"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20settings%20%3E%20(property)%20min_tls_version%20%3E%20(member)%201">Link to this property</a>

const CustomHostnameGetResponseSSLSettingsMinTLSVersion1\_2 CustomHostnameGetResponseSSLSettingsMinTLSVersion = "1.2"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20settings%20%3E%20(property)%20min_tls_version%20%3E%20(member)%202">Link to this property</a>

const CustomHostnameGetResponseSSLSettingsMinTLSVersion1\_3 CustomHostnameGetResponseSSLSettingsMinTLSVersion = "1.3"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20settings%20%3E%20(property)%20min_tls_version%20%3E%20(member)%203">Link to this property</a>

</details>

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20settings%20%3E%20(property)%20min_tls_version">Link to this property</a>

<details>

<summary>

TLS1\_3 CustomHostnameGetResponseSSLSettingsTLS1\_3Optional

Whether or not TLS 1.3 is enabled.

</summary>

One of the following:

const CustomHostnameGetResponseSSLSettingsTLS1\_3On CustomHostnameGetResponseSSLSettingsTLS1\_3 = "on"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20settings%20%3E%20(property)%20tls_1_3%20%3E%20(member)%200">Link to this property</a>

const CustomHostnameGetResponseSSLSettingsTLS1\_3Off CustomHostnameGetResponseSSLSettingsTLS1\_3 = "off"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20settings%20%3E%20(property)%20tls_1_3%20%3E%20(member)%201">Link to this property</a>

</details>

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20settings%20%3E%20(property)%20tls_1_3">Link to this property</a>

</details>

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20settings">Link to this property</a>

Signature stringOptional

The signature on a custom uploaded certificate.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20signature">Link to this property</a>

<details>

<summary>

Status CustomHostnameGetResponseSSLStatusOptional

Status of the hostname’s SSL certificates.

</summary>

One of the following:

const CustomHostnameGetResponseSSLStatusInitializing CustomHostnameGetResponseSSLStatus = "initializing"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%200">Link to this property</a>

const CustomHostnameGetResponseSSLStatusPendingValidation CustomHostnameGetResponseSSLStatus = "pending\_validation"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%201">Link to this property</a>

const CustomHostnameGetResponseSSLStatusDeleted CustomHostnameGetResponseSSLStatus = "deleted"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%202">Link to this property</a>

const CustomHostnameGetResponseSSLStatusPendingIssuance CustomHostnameGetResponseSSLStatus = "pending\_issuance"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%203">Link to this property</a>

const CustomHostnameGetResponseSSLStatusPendingDeployment CustomHostnameGetResponseSSLStatus = "pending\_deployment"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%204">Link to this property</a>

const CustomHostnameGetResponseSSLStatusPendingDeletion CustomHostnameGetResponseSSLStatus = "pending\_deletion"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%205">Link to this property</a>

const CustomHostnameGetResponseSSLStatusPendingExpiration CustomHostnameGetResponseSSLStatus = "pending\_expiration"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%206">Link to this property</a>

const CustomHostnameGetResponseSSLStatusExpired CustomHostnameGetResponseSSLStatus = "expired"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%207">Link to this property</a>

const CustomHostnameGetResponseSSLStatusActive CustomHostnameGetResponseSSLStatus = "active"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%208">Link to this property</a>

const CustomHostnameGetResponseSSLStatusInitializingTimedOut CustomHostnameGetResponseSSLStatus = "initializing\_timed\_out"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%209">Link to this property</a>

const CustomHostnameGetResponseSSLStatusValidationTimedOut CustomHostnameGetResponseSSLStatus = "validation\_timed\_out"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%2010">Link to this property</a>

const CustomHostnameGetResponseSSLStatusIssuanceTimedOut CustomHostnameGetResponseSSLStatus = "issuance\_timed\_out"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%2011">Link to this property</a>

const CustomHostnameGetResponseSSLStatusDeploymentTimedOut CustomHostnameGetResponseSSLStatus = "deployment\_timed\_out"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%2012">Link to this property</a>

const CustomHostnameGetResponseSSLStatusDeletionTimedOut CustomHostnameGetResponseSSLStatus = "deletion\_timed\_out"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%2013">Link to this property</a>

const CustomHostnameGetResponseSSLStatusPendingCleanup CustomHostnameGetResponseSSLStatus = "pending\_cleanup"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%2014">Link to this property</a>

const CustomHostnameGetResponseSSLStatusStagingDeployment CustomHostnameGetResponseSSLStatus = "staging\_deployment"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%2015">Link to this property</a>

const CustomHostnameGetResponseSSLStatusStagingActive CustomHostnameGetResponseSSLStatus = "staging\_active"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%2016">Link to this property</a>

const CustomHostnameGetResponseSSLStatusDeactivating CustomHostnameGetResponseSSLStatus = "deactivating"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%2017">Link to this property</a>

const CustomHostnameGetResponseSSLStatusInactive CustomHostnameGetResponseSSLStatus = "inactive"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%2018">Link to this property</a>

const CustomHostnameGetResponseSSLStatusBackupIssued CustomHostnameGetResponseSSLStatus = "backup\_issued"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%2019">Link to this property</a>

const CustomHostnameGetResponseSSLStatusHoldingDeployment CustomHostnameGetResponseSSLStatus = "holding\_deployment"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status%20%3E%20(member)%2020">Link to this property</a>

</details>

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20status">Link to this property</a>

Type <a href="https://developers.cloudflare.com/api/go/resources/custom_hostnames#(resource)%20custom_hostnames%20%3E%20(model)%20domain_validation_type%20%3E%20(schema)">DomainValidationType</a>Optional

Level of validation to be used for this hostname. Domain validation (dv) must be used.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20type">Link to this property</a>

UploadedOn TimeOptional

The time the custom certificate was uploaded.

formatdate-time

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20uploaded_on">Link to this property</a>

<details>

<summary>

ValidationErrors \[]CustomHostnameGetResponseSSLValidationErrorOptional

Domain validation errors that have been received by the certificate authority (CA).

</summary>

Message stringOptional

A domain validation error.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20validation_errors%20%3E%20(items)%20%3E%20(property)%20message">Link to this property</a>

</details>

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20validation_errors">Link to this property</a>

<details>

<summary>

ValidationRecords \[]CustomHostnameGetResponseSSLValidationRecordOptional

</summary>

CNAME stringOptional

The CNAME record hostname for DCV delegation.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20validation_records%20%3E%20(items)%20%3E%20(property)%20cname">Link to this property</a>

CNAMETarget stringOptional

The CNAME record target value for DCV delegation.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20validation_records%20%3E%20(items)%20%3E%20(property)%20cname_target">Link to this property</a>

Emails \[]stringOptional

The set of email addresses that the certificate authority (CA) will use to complete domain validation.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20validation_records%20%3E%20(items)%20%3E%20(property)%20emails">Link to this property</a>

HTTPBody stringOptional

The content that the certificate authority (CA) will expect to find at the http\_url during the domain validation.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20validation_records%20%3E%20(items)%20%3E%20(property)%20http_body">Link to this property</a>

HTTPURL stringOptional

The url that will be checked during domain validation.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20validation_records%20%3E%20(items)%20%3E%20(property)%20http_url">Link to this property</a>

Status stringOptional

Status of the validation record.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20validation_records%20%3E%20(items)%20%3E%20(property)%20status">Link to this property</a>

TXTName stringOptional

The hostname that the certificate authority (CA) will check for a TXT record during domain validation .

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20validation_records%20%3E%20(items)%20%3E%20(property)%20txt_name">Link to this property</a>

TXTValue stringOptional

The TXT record that the certificate authority (CA) will check during domain validation.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20validation_records%20%3E%20(items)%20%3E%20(property)%20txt_value">Link to this property</a>

</details>

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20validation_records">Link to this property</a>

Wildcard boolOptional

Indicates whether the certificate covers a wildcard.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl%20%3E%20(property)%20wildcard">Link to this property</a>

</details>

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20ssl">Link to this property</a>

<details>

<summary>

Status CustomHostnameGetResponseStatusOptional

Status of the hostname’s activation.

</summary>

One of the following:

const CustomHostnameGetResponseStatusActive CustomHostnameGetResponseStatus = "active"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%200">Link to this property</a>

const CustomHostnameGetResponseStatusPending CustomHostnameGetResponseStatus = "pending"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%201">Link to this property</a>

const CustomHostnameGetResponseStatusActiveRedeploying CustomHostnameGetResponseStatus = "active\_redeploying"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%202">Link to this property</a>

const CustomHostnameGetResponseStatusMoved CustomHostnameGetResponseStatus = "moved"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%203">Link to this property</a>

const CustomHostnameGetResponseStatusPendingDeletion CustomHostnameGetResponseStatus = "pending\_deletion"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%204">Link to this property</a>

const CustomHostnameGetResponseStatusDeleted CustomHostnameGetResponseStatus = "deleted"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%205">Link to this property</a>

const CustomHostnameGetResponseStatusPendingBlocked CustomHostnameGetResponseStatus = "pending\_blocked"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%206">Link to this property</a>

const CustomHostnameGetResponseStatusPendingMigration CustomHostnameGetResponseStatus = "pending\_migration"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%207">Link to this property</a>

const CustomHostnameGetResponseStatusPendingProvisioned CustomHostnameGetResponseStatus = "pending\_provisioned"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%208">Link to this property</a>

const CustomHostnameGetResponseStatusTestPending CustomHostnameGetResponseStatus = "test\_pending"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%209">Link to this property</a>

const CustomHostnameGetResponseStatusTestActive CustomHostnameGetResponseStatus = "test\_active"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%2010">Link to this property</a>

const CustomHostnameGetResponseStatusTestActiveApex CustomHostnameGetResponseStatus = "test\_active\_apex"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%2011">Link to this property</a>

const CustomHostnameGetResponseStatusTestBlocked CustomHostnameGetResponseStatus = "test\_blocked"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%2012">Link to this property</a>

const CustomHostnameGetResponseStatusTestFailed CustomHostnameGetResponseStatus = "test\_failed"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%2013">Link to this property</a>

const CustomHostnameGetResponseStatusProvisioned CustomHostnameGetResponseStatus = "provisioned"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%2014">Link to this property</a>

const CustomHostnameGetResponseStatusBlocked CustomHostnameGetResponseStatus = "blocked"

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%2015">Link to this property</a>

</details>

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20status">Link to this property</a>

VerificationErrors \[]stringOptional

These are errors that were encountered while trying to activate a hostname.

<a href="#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)%20%3E%20(property)%20verification_errors">Link to this property</a>

</details>

[Link to this property](<#(resource)%20custom_hostnames%20%3E%20(model)%20CustomHostnameGetResponse%20%3E%20(schema)>)

### Custom Hostname Details

Go

HTTPTypeScriptPythonGoTerraform

```
package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/custom_hostnames"
  "github.com/cloudflare/cloudflare-go/option"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  customHostname, err := client.CustomHostnames.Get(
    context.TODO(),
    "0d89c70d-ad9f-4843-b99f-6cc0252067e9",
    custom_hostnames.CustomHostnameGetParams{
      ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", customHostname.ID)
}
```

200 example

```
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    "string"
  ],
  "success": true,
  "result": {
    "id": "0d89c70d-ad9f-4843-b99f-6cc0252067e9",
    "hostname": "app.example.com",
    "created_at": "2020-02-06T18:11:23.531995Z",
    "custom_metadata": {
      "foo": "string"
    },
    "custom_origin_server": "origin2.example.com",
    "custom_origin_sni": "sni.example.com",
    "ownership_verification": {
      "name": "_cf-custom-hostname.app.example.com",
      "type": "txt",
      "value": "5cc07c04-ea62-4a5a-95f0-419334a875a4"
    },
    "ownership_verification_http": {
      "http_body": "5cc07c04-ea62-4a5a-95f0-419334a875a4",
      "http_url": "http://custom.test.com/.well-known/cf-custom-hostname-challenge/0d89c70d-ad9f-4843-b99f-6cc0252067e9"
    },
    "ssl": {
      "id": "0d89c70d-ad9f-4843-b99f-6cc0252067e9",
      "bundle_method": "ubiquitous",
      "certificate_authority": "google",
      "custom_certificate": "-----BEGIN CERTIFICATE-----\nMIIFJDCCBAygAwIBAgIQD0ifmj/Yi5NP/2gdUySbfzANBgkqhkiG9w0BAQsFADBN\nMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMScwJQYDVQQDEx5E...SzSHfXp5lnu/3V08I72q1QNzOCgY1XeL4GKVcj4or6cT6tX6oJH7ePPmfrBfqI/O\nOeH8gMJ+FuwtXYEPa4hBf38M5eU5xWG7\n-----END CERTIFICATE-----\n",
      "custom_csr_id": "7b163417-1d2b-4c84-a38a-2fb7a0cd7752",
      "custom_key": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIBAAKCAQEAwQHoetcl9+5ikGzV6cMzWtWPJHqXT3wpbEkRU9Yz7lgvddmG\ndtcGbg/1CGZu0jJGkMoppoUo4c3dts3iwqRYmBikUP77wwY2QGmDZw2FvkJCJlKn\nabIRuGvBKwzESIXgKk2016aTP6/dAjEHyo6SeoK8lkIySUvK0fyOVlsiEsCmOpid\ntnKX/a+50GjB79CJH4ER2lLVZnhePFR/zUOyPxZQQ4naHf7yu/b5jhO0f8fwt+py\nFxIXjbEIdZliWRkRMtzrHOJIhrmJ2A1J7iOrirbbwillwjjNVUWPf3IJ3M12S9pE\newooaeO2izNTERcG9HzAacbVRn2Y2SWIyT/18QIDAQABAoIBACbhTYXBZYKmYPCb\nHBR1IBlCQA2nLGf0qRuJNJZg5iEzXows/6tc8YymZkQE7nolapWsQ+upk2y5Xdp/\naxiuprIs9JzkYK8Ox0r+dlwCG1kSW+UAbX0bQ/qUqlsTvU6muVuMP8vZYHxJ3wmb\n+ufRBKztPTQ/rYWaYQcgC0RWI20HTFBMxlTAyNxYNWzX7RKFkGVVyB9RsAtmcc8g\n+j4OdosbfNoJPS0HeIfNpAznDfHKdxDk2Yc1tV6RHBrC1ynyLE9+TaflIAdo2MVv\nKLMLq51GqYKtgJFIlBRPQqKoyXdz3fGvXrTkf/WY9QNq0J1Vk5ERePZ54mN8iZB7\n9lwy/AkCgYEA6FXzosxswaJ2wQLeoYc7ceaweX/SwTvxHgXzRyJIIT0eJWgx13Wo\n/WA3Iziimsjf6qE+SI/8laxPp2A86VMaIt3Z3mJN/CqSVGw8LK2AQst+OwdPyDMu\niacE8lj/IFGC8mwNUAb9CzGU3JpU4PxxGFjS/eMtGeRXCWkK4NE+G08CgYEA1Kp9\nN2JrVlqUz+gAX+LPmE9OEMAS9WQSQsfCHGogIFDGGcNf7+uwBM7GAaSJIP01zcoe\nVAgWdzXCv3FLhsaZoJ6RyLOLay5phbu1iaTr4UNYm5WtYTzMzqh8l1+MFFDl9xDB\nvULuCIIrglM5MeS/qnSg1uMoH2oVPj9TVst/ir8CgYEAxrI7Ws9Zc4Bt70N1As+U\nlySjaEVZCMkqvHJ6TCuVZFfQoE0r0whdLdRLU2PsLFP+q7qaeZQqgBaNSKeVcDYR\n9B+nY/jOmQoPewPVsp/vQTCnE/R81spu0mp0YI6cIheT1Z9zAy322svcc43JaWB7\nmEbeqyLOP4Z4qSOcmghZBSECgYACvR9Xs0DGn+wCsW4vze/2ei77MD4OQvepPIFX\ndFZtlBy5ADcgE9z0cuVB6CiL8DbdK5kwY9pGNr8HUCI03iHkW6Zs+0L0YmihfEVe\nPG19PSzK9CaDdhD9KFZSbLyVFmWfxOt50H7YRTTiPMgjyFpfi5j2q348yVT0tEQS\nfhRqaQKBgAcWPokmJ7EbYQGeMbS7HC8eWO/RyamlnSffdCdSc7ue3zdVJxpAkQ8W\nqu80pEIF6raIQfAf8MXiiZ7auFOSnHQTXUbhCpvDLKi0Mwq3G8Pl07l+2s6dQG6T\nlv6XTQaMyf6n1yjzL+fzDrH3qXMxHMO/b13EePXpDMpY7HQpoLDi\n-----END RSA PRIVATE KEY-----\n",
      "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"
        }
      ],
      "expires_on": "2021-02-06T18:11:23.531995Z",
      "hosts": [
        "app.example.com",
        "*.app.example.com"
      ],
      "issuer": "DigiCertInc",
      "method": "http",
      "serial_number": "6743787633689793699141714808227354901",
      "settings": {
        "ciphers": [
          "ECDHE-RSA-AES128-GCM-SHA256",
          "AES128-SHA"
        ],
        "early_hints": "on",
        "http2": "on",
        "min_tls_version": "1.2",
        "tls_1_3": "on"
      },
      "signature": "SHA256WithRSA",
      "status": "pending_validation",
      "type": "dv",
      "uploaded_on": "2020-02-06T18:11:23.531995Z",
      "validation_errors": [
        {
          "message": "SERVFAIL looking up CAA for app.example.com"
        }
      ],
      "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"
        }
      ],
      "wildcard": false
    },
    "status": "pending",
    "verification_errors": [
      "None of the A or AAAA records are owned by this account and the pre-generated ownership verification token was not found."
    ]
  }
}
```

##### Returns Examples

200 example

```
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    "string"
  ],
  "success": true,
  "result": {
    "id": "0d89c70d-ad9f-4843-b99f-6cc0252067e9",
    "hostname": "app.example.com",
    "created_at": "2020-02-06T18:11:23.531995Z",
    "custom_metadata": {
      "foo": "string"
    },
    "custom_origin_server": "origin2.example.com",
    "custom_origin_sni": "sni.example.com",
    "ownership_verification": {
      "name": "_cf-custom-hostname.app.example.com",
      "type": "txt",
      "value": "5cc07c04-ea62-4a5a-95f0-419334a875a4"
    },
    "ownership_verification_http": {
      "http_body": "5cc07c04-ea62-4a5a-95f0-419334a875a4",
      "http_url": "http://custom.test.com/.well-known/cf-custom-hostname-challenge/0d89c70d-ad9f-4843-b99f-6cc0252067e9"
    },
    "ssl": {
      "id": "0d89c70d-ad9f-4843-b99f-6cc0252067e9",
      "bundle_method": "ubiquitous",
      "certificate_authority": "google",
      "custom_certificate": "-----BEGIN CERTIFICATE-----\nMIIFJDCCBAygAwIBAgIQD0ifmj/Yi5NP/2gdUySbfzANBgkqhkiG9w0BAQsFADBN\nMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMScwJQYDVQQDEx5E...SzSHfXp5lnu/3V08I72q1QNzOCgY1XeL4GKVcj4or6cT6tX6oJH7ePPmfrBfqI/O\nOeH8gMJ+FuwtXYEPa4hBf38M5eU5xWG7\n-----END CERTIFICATE-----\n",
      "custom_csr_id": "7b163417-1d2b-4c84-a38a-2fb7a0cd7752",
      "custom_key": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIBAAKCAQEAwQHoetcl9+5ikGzV6cMzWtWPJHqXT3wpbEkRU9Yz7lgvddmG\ndtcGbg/1CGZu0jJGkMoppoUo4c3dts3iwqRYmBikUP77wwY2QGmDZw2FvkJCJlKn\nabIRuGvBKwzESIXgKk2016aTP6/dAjEHyo6SeoK8lkIySUvK0fyOVlsiEsCmOpid\ntnKX/a+50GjB79CJH4ER2lLVZnhePFR/zUOyPxZQQ4naHf7yu/b5jhO0f8fwt+py\nFxIXjbEIdZliWRkRMtzrHOJIhrmJ2A1J7iOrirbbwillwjjNVUWPf3IJ3M12S9pE\newooaeO2izNTERcG9HzAacbVRn2Y2SWIyT/18QIDAQABAoIBACbhTYXBZYKmYPCb\nHBR1IBlCQA2nLGf0qRuJNJZg5iEzXows/6tc8YymZkQE7nolapWsQ+upk2y5Xdp/\naxiuprIs9JzkYK8Ox0r+dlwCG1kSW+UAbX0bQ/qUqlsTvU6muVuMP8vZYHxJ3wmb\n+ufRBKztPTQ/rYWaYQcgC0RWI20HTFBMxlTAyNxYNWzX7RKFkGVVyB9RsAtmcc8g\n+j4OdosbfNoJPS0HeIfNpAznDfHKdxDk2Yc1tV6RHBrC1ynyLE9+TaflIAdo2MVv\nKLMLq51GqYKtgJFIlBRPQqKoyXdz3fGvXrTkf/WY9QNq0J1Vk5ERePZ54mN8iZB7\n9lwy/AkCgYEA6FXzosxswaJ2wQLeoYc7ceaweX/SwTvxHgXzRyJIIT0eJWgx13Wo\n/WA3Iziimsjf6qE+SI/8laxPp2A86VMaIt3Z3mJN/CqSVGw8LK2AQst+OwdPyDMu\niacE8lj/IFGC8mwNUAb9CzGU3JpU4PxxGFjS/eMtGeRXCWkK4NE+G08CgYEA1Kp9\nN2JrVlqUz+gAX+LPmE9OEMAS9WQSQsfCHGogIFDGGcNf7+uwBM7GAaSJIP01zcoe\nVAgWdzXCv3FLhsaZoJ6RyLOLay5phbu1iaTr4UNYm5WtYTzMzqh8l1+MFFDl9xDB\nvULuCIIrglM5MeS/qnSg1uMoH2oVPj9TVst/ir8CgYEAxrI7Ws9Zc4Bt70N1As+U\nlySjaEVZCMkqvHJ6TCuVZFfQoE0r0whdLdRLU2PsLFP+q7qaeZQqgBaNSKeVcDYR\n9B+nY/jOmQoPewPVsp/vQTCnE/R81spu0mp0YI6cIheT1Z9zAy322svcc43JaWB7\nmEbeqyLOP4Z4qSOcmghZBSECgYACvR9Xs0DGn+wCsW4vze/2ei77MD4OQvepPIFX\ndFZtlBy5ADcgE9z0cuVB6CiL8DbdK5kwY9pGNr8HUCI03iHkW6Zs+0L0YmihfEVe\nPG19PSzK9CaDdhD9KFZSbLyVFmWfxOt50H7YRTTiPMgjyFpfi5j2q348yVT0tEQS\nfhRqaQKBgAcWPokmJ7EbYQGeMbS7HC8eWO/RyamlnSffdCdSc7ue3zdVJxpAkQ8W\nqu80pEIF6raIQfAf8MXiiZ7auFOSnHQTXUbhCpvDLKi0Mwq3G8Pl07l+2s6dQG6T\nlv6XTQaMyf6n1yjzL+fzDrH3qXMxHMO/b13EePXpDMpY7HQpoLDi\n-----END RSA PRIVATE KEY-----\n",
      "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"
        }
      ],
      "expires_on": "2021-02-06T18:11:23.531995Z",
      "hosts": [
        "app.example.com",
        "*.app.example.com"
      ],
      "issuer": "DigiCertInc",
      "method": "http",
      "serial_number": "6743787633689793699141714808227354901",
      "settings": {
        "ciphers": [
          "ECDHE-RSA-AES128-GCM-SHA256",
          "AES128-SHA"
        ],
        "early_hints": "on",
        "http2": "on",
        "min_tls_version": "1.2",
        "tls_1_3": "on"
      },
      "signature": "SHA256WithRSA",
      "status": "pending_validation",
      "type": "dv",
      "uploaded_on": "2020-02-06T18:11:23.531995Z",
      "validation_errors": [
        {
          "message": "SERVFAIL looking up CAA for app.example.com"
        }
      ],
      "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"
        }
      ],
      "wildcard": false
    },
    "status": "pending",
    "verification_errors": [
      "None of the A or AAAA records are owned by this account and the pre-generated ownership verification token was not found."
    ]
  }
}
```