Domains

Get a domain

Returns the domain and its current verification status. The status is refreshed on every request.

Required scope: domains:read

get/clusters/{cluster_id}/domains/{domain_id}

Request

  • Base URL: http://localhost:8000
  • URL: http://localhost:8000/clusters/{cluster_id}/domains/{domain_id}
  • Auth: API key in header API-Key

Path parameters

cluster_idstring uuid required
domain_idstring uuid required

Headers

API-Version'2026-06-01.beta' required

Response

The request has succeeded.

idstring uuid required
cluster_idstring uuid required
domainstring required

A fully-qualified domain name.

subdomainstring

Optional subdomain prefix.

verification_status'unverified' | 'pending' | 'verified' | 'failed' required
ssl_status'pending' | 'active' | 'failed' | 'expired' required
cname_targetstring required

CNAME target. Point your domain's DNS CNAME record to this value to route traffic to the cluster.

is_activeboolean required

true when the domain is verified and its SSL certificate is active.

last_checked_atstring date-time

When Skycloak last checked this domain's status with Cloudflare. Pending domains are checked every few minutes for 48 hours, then hourly, then daily after 30 days. Absent until the first check.

last_check_errorstring

Cloudflare's reason the domain is not active yet, from the last check. Absent when there is none.

created_atstring date-time required
updated_atstring date-time required

Example response

{
  "domain": "auth.mycompany.com",
  "subdomain": "auth",
  "last_check_error": "custom hostname does not CNAME to this zone."
}

Changes

No recorded changes to this operation across all 1 revision of this API.