HostView

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/dnsmint-com/json-schema/dnsmint-com-host-view-schema.json",
  "title": "HostView",
  "description": "A hostname. Where it points is deliberately not here: `ip`, `record_type` and the target are either something you just sent or something DNS answers authoritatively, and a second copy in this body can only disagree with it. Ask /v1/hostnames/{id}/diagnose for where it points and what we observed, with the time we observed it.",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/dnsmint-com-api-openapi.json#/components/schemas/HostView",
  "type": "object",
  "required": [
    "id",
    "hostname",
    "status",
    "certificate",
    "created_at"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Opaque identifier used in the /v1/hostnames/{id} paths."
    },
    "hostname": {
      "type": "string",
      "description": "The fully qualified hostname: an opaque subdomain on a domain assigned to your account."
    },
    "status": {
      "type": "string",
      "enum": [
        "pending",
        "live",
        "released",
        "suspended",
        "terminated"
      ],
      "x-status-docs": [
        {
          "value": "pending",
          "means": "Registered, not yet confirmed on the nameservers. Poll GET until it goes live.",
          "writes": "Accepted"
        },
        {
          "value": "live",
          "means": "The record is served, and it stays so until you release it.",
          "writes": "Accepted"
        },
        {
          "value": "released",
          "means": "You released it. It stops appearing in listings, and the subdomain is yours to mint again as a new hostname.",
          "writes": "409"
        },
        {
          "value": "suspended",
          "means": "Held while an abuse report is reviewed. It stops resolving, but nothing is lost: if the report is not upheld the hostname, its IP and its DNS-01 credentials all come back.",
          "writes": "403"
        },
        {
          "value": "terminated",
          "means": "An abuse report was upheld. Not reversible, and it stops appearing in listings.",
          "writes": "409"
        }
      ],
      "description": "pending: registered, not yet confirmed on the nameservers. live: the record is served, and it stays so until you release it. released: you released it; writes return 409 and the subdomain can be minted again as a new hostname. suspended: held while an abuse report is reviewed; it stops resolving and writes return 403, but nothing is lost if the report is not upheld. terminated: an abuse report was upheld, not reversible. New registrations may briefly return pending; poll GET until live."
    },
    "certificate": {
      "type": "string",
      "enum": [
        "self",
        "csr",
        "managed"
      ],
      "description": "Who holds the private key. self: you, and you run the ACME client. csr: you hold the key and we run the protocol around your signed request. managed: we generate the key, obtain and renew the certificate, and keep a copy for you to fetch."
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "When the hostname was registered."
    }
  }
}