{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/linkbreakers-com/json-schema/linkbreakers-com-list-custom-domains-response-schema.json",
  "title": "Response containing a list of custom domains",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/linkbreakers-com-custom-domains-api-openapi.yml#/components/schemas/ListCustomDomainsResponse",
  "properties": {
    "customDomains": {
      "items": {
        "$ref": "#/$defs/CustomDomain",
        "type": "object"
      },
      "type": "array"
    },
    "nextPageToken": {
      "description": "Cursor to continue listing custom domains. Empty on the last page.",
      "type": "string"
    },
    "totalCount": {
      "description": "How many records exist in total, so a client can tell a complete answer\nfrom a page of one. A local-first client reads absence from this list as\ndeletion, and may only do so when the count it was given matches what it\nreceived: without that, one page would look like the whole model and\neverything beyond it would be removed locally.",
      "format": "int64",
      "type": "integer"
    }
  },
  "type": "object",
  "$defs": {
    "CustomDomain": {
      "description": "Captures a branded hostname that Linkbreakers provisions for a workspace so scans and shortlinks resolve\nunder the customer's domain, including verification and certificate lifecycle state.",
      "properties": {
        "activatedAt": {
          "description": "Timestamp when the domain became active after passing verification and certificate checks.",
          "format": "date-time",
          "readOnly": true,
          "title": "Timestamp when the domain was successfully set as active",
          "type": "string"
        },
        "certificateExpiresAt": {
          "description": "When the certificate currently serving this domain expires. While the status is STATUS_RENEWAL_PENDING the domain keeps working until this date, then stops.",
          "format": "date-time",
          "readOnly": true,
          "title": "Expiry of the certificate currently serving this domain",
          "type": "string"
        },
        "cloudflareHostnameStatus": {
          "description": "Raw hostname status reported by the certificate provider, recorded at the last check.",
          "readOnly": true,
          "title": "Raw hostname status reported by the certificate provider",
          "type": "string"
        },
        "cloudflareSslStatus": {
          "description": "Raw SSL status reported by the certificate provider, recorded at the last check.",
          "readOnly": true,
          "title": "Raw SSL status reported by the certificate provider",
          "type": "string"
        },
        "createdAt": {
          "format": "date-time",
          "readOnly": true,
          "title": "Timestamp when the domain was created",
          "type": "string"
        },
        "id": {
          "title": "Unique identifier for the custom domain (UUID)",
          "type": "string"
        },
        "lastCheckedAt": {
          "format": "date-time",
          "readOnly": true,
          "title": "Timestamp of the last verification check",
          "type": "string"
        },
        "lastError": {
          "description": "Human-readable reason the domain is not fully active, as reported at the last check. Empty when the domain is healthy.",
          "readOnly": true,
          "title": "Why the domain is not fully active",
          "type": "string"
        },
        "name": {
          "title": "The domain name",
          "type": "string"
        },
        "rootDestination": {
          "description": "URL where visitors are redirected when accessing your custom domain without a path (e.g., qr.yourdomain.com). This redirect is not tracked and serves purely for white-label purposes—preventing visitors from seeing linkbreakers.com branding. If not specified, redirects to linkbreakers.com by default.",
          "title": "Root destination URL",
          "type": "string"
        },
        "status": {
          "description": "The status of a custom domain\n\n - STATUS_UNSPECIFIED: The status is not specified\n - STATUS_INACTIVE: The domain is inactive. It was created but not checked yet.\n - STATUS_DOMAIN_PENDING: The domain is pending. Last time it was checked, it was not pointing to the correct Linkbreakers subdomain.\n - STATUS_VERIFICATION_PENDING: The domain is pending verification. Please verify through TXT record.\n - STATUS_CERTIFICATE_PENDING: The domain is pending certificate. The SSL certificate is not yet ready.\n - STATUS_ACTIVE: The domain is fully active\n - STATUS_RENEWAL_PENDING: The domain is still serving traffic on a valid certificate, but the renewal\nof that certificate cannot be validated. It stops working at certificate_expires_at.\n - STATUS_EXPIRED: The certificate expired or was withdrawn. The domain no longer serves HTTPS.",
          "enum": [
            "STATUS_UNSPECIFIED",
            "STATUS_INACTIVE",
            "STATUS_DOMAIN_PENDING",
            "STATUS_VERIFICATION_PENDING",
            "STATUS_CERTIFICATE_PENDING",
            "STATUS_ACTIVE",
            "STATUS_RENEWAL_PENDING",
            "STATUS_EXPIRED"
          ]
        },
        "updatedAt": {
          "format": "date-time",
          "readOnly": true,
          "title": "Timestamp when the domain was last updated",
          "type": "string"
        },
        "workspaceId": {
          "title": "The ID of the workspace this domain belongs to (UUID)",
          "type": "string"
        }
      },
      "title": "Custom domain",
      "type": "object"
    }
  }
}