zones_zone

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/cloudflare/main/json-schema/cloudflare-zones-zone-schema.json",
  "title": "zones_zone",
  "x-generated": "2026-10-03",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/cloudflare-zones-api-openapi.yml#/components/schemas/zones_zone",
  "type": "object",
  "required": [
    "id",
    "name",
    "development_mode",
    "owner",
    "account",
    "meta",
    "original_name_servers",
    "original_registrar",
    "original_dnshost",
    "created_on",
    "modified_on",
    "activated_on"
  ],
  "properties": {
    "account": {
      "type": "object",
      "description": "The account the zone belongs to",
      "properties": {
        "id": {
          "$ref": "#/$defs/zones_identifier"
        },
        "name": {
          "type": "string",
          "description": "The name of the account"
        }
      }
    },
    "activated_on": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "The last time proof of ownership was detected and the zone was made\nactive",
      "readOnly": true
    },
    "created_on": {
      "type": "string",
      "format": "date-time",
      "description": "When the zone was created",
      "readOnly": true
    },
    "development_mode": {
      "type": "number",
      "description": "The interval (in seconds) from when development mode expires\n(positive integer) or last expired (negative integer) for the\ndomain. If development mode has never been enabled, this value is 0.",
      "readOnly": true
    },
    "id": {
      "$ref": "#/$defs/zones_identifier"
    },
    "meta": {
      "type": "object",
      "description": "Metadata about the zone",
      "properties": {
        "cdn_only": {
          "type": "boolean",
          "description": "The zone is only configured for CDN"
        },
        "custom_certificate_quota": {
          "type": "integer",
          "description": "Number of Custom Certificates the zone can have"
        },
        "dns_only": {
          "type": "boolean",
          "description": "The zone is only configured for DNS"
        },
        "foundation_dns": {
          "type": "boolean",
          "description": "The zone is setup with Foundation DNS"
        },
        "page_rule_quota": {
          "type": "integer",
          "description": "Number of Page Rules a zone can have"
        },
        "phishing_detected": {
          "type": "boolean",
          "description": "The zone has been flagged for phishing"
        },
        "step": {
          "type": "integer"
        }
      }
    },
    "modified_on": {
      "type": "string",
      "format": "date-time",
      "description": "When the zone was last modified",
      "readOnly": true
    },
    "name": {
      "type": "string",
      "description": "The domain name",
      "maxLength": 253,
      "pattern": "^([a-zA-Z0-9][\\-a-zA-Z0-9]*\\.)+[\\-a-zA-Z0-9]{2,20}$"
    },
    "original_dnshost": {
      "type": [
        "string",
        "null"
      ],
      "description": "DNS host at the time of switching to Cloudflare",
      "readOnly": true,
      "maxLength": 50
    },
    "original_name_servers": {
      "type": [
        "array",
        "null"
      ],
      "description": "Original name servers before moving to Cloudflare\nNotes: Is this only available for full zones?",
      "readOnly": true,
      "items": {
        "type": "string",
        "format": "hostname"
      }
    },
    "original_registrar": {
      "type": [
        "string",
        "null"
      ],
      "description": "Registrar for the domain at the time of switching to Cloudflare",
      "readOnly": true
    },
    "owner": {
      "type": "object",
      "description": "The owner of the zone",
      "properties": {
        "id": {
          "$ref": "#/$defs/zones_identifier"
        },
        "name": {
          "type": "string",
          "description": "Name of the owner"
        },
        "type": {
          "type": "string",
          "description": "The type of owner"
        }
      }
    },
    "vanity_name_servers": {
      "type": "array",
      "description": "An array of domains used for custom name servers. This is only available for Business and Enterprise plans.",
      "items": {
        "type": "string",
        "format": "hostname",
        "maxLength": 253
      }
    }
  },
  "$defs": {
    "zones_identifier": {
      "type": "string",
      "description": "Identifier",
      "maxLength": 32
    }
  }
}