{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/pagegoat-com/json-schema/pagegoat-com-visitor-page-schema.json",
  "title": "VisitorPage",
  "description": "A page of captured visitors and the list's totals.",
  "x-generated": "2026-11-20",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/pagegoat-com-openapi.yml#/components/schemas/VisitorPage",
  "required": [
    "items",
    "lastSevenDays",
    "matching",
    "page",
    "pending",
    "size",
    "total",
    "verified"
  ],
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Visitor"
      }
    },
    "page": {
      "type": "integer",
      "description": "Zero-based page index.",
      "format": "int32"
    },
    "size": {
      "type": "integer",
      "description": "Rows per page.",
      "format": "int32"
    },
    "matching": {
      "type": "integer",
      "description": "Rows matching the current filters, across all pages.",
      "format": "int64"
    },
    "total": {
      "type": "integer",
      "description": "Every address captured on this site, ignoring the filters.",
      "format": "int64"
    },
    "verified": {
      "type": "integer",
      "description": "How many have confirmed a code at least once.",
      "format": "int64"
    },
    "pending": {
      "type": "integer",
      "description": "Sent a code, never used it.",
      "format": "int64"
    },
    "lastSevenDays": {
      "type": "integer",
      "description": "First seen in the last seven days.",
      "format": "int64"
    }
  },
  "$defs": {
    "Visitor": {
      "required": [
        "email",
        "firstSeenAt",
        "id",
        "status"
      ],
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Row id, for the row actions.",
          "format": "uuid"
        },
        "email": {
          "type": "string",
          "description": "The address, lowercased."
        },
        "status": {
          "type": "string",
          "description": "`verified` got in; `pending` was sent a code and never used it; `blocked` was refused by an admin.",
          "enum": [
            "pending",
            "verified",
            "blocked"
          ]
        },
        "firstSeenAt": {
          "type": "string",
          "description": "First time this address was offered at the gate.",
          "format": "date-time"
        }
      },
      "description": "An email address captured at a site's email gate."
    }
  }
}