RegisterChange

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/insurers-global/json-schema/insurers-global-register-change-schema.json",
  "title": "RegisterChange",
  "description": "One accepted change from the daily register watch, applied on top of the workbook by scripts/build-data.mjs: an add from the watch itself (review \"bot-researched\" until a person checks it), or a rename, removal or class change the owner accepted.",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/insurers-global-openapi.json#/components/schemas/RegisterChange",
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "type": {
      "type": "string",
      "enum": [
        "add",
        "rename",
        "remove",
        "class_change"
      ]
    },
    "date": {
      "type": "string",
      "format": "date"
    },
    "country": {
      "type": "string",
      "description": "Country slug"
    },
    "continent": {
      "type": "string",
      "enum": [
        "africa",
        "europe",
        "asia-pacific",
        "south-america",
        "north-america"
      ]
    },
    "company": {
      "type": "string"
    },
    "previousName": {
      "type": [
        "string",
        "null"
      ],
      "description": "The name the directory held before a rename; null otherwise."
    },
    "class": {
      "type": [
        "string",
        "null"
      ],
      "description": "Class of business slug, or null when the register states none."
    },
    "evidence": {
      "type": "string",
      "description": "A verbatim quote from the register text"
    },
    "sourceUrl": {
      "type": "string",
      "format": "uri"
    },
    "review": {
      "type": "string",
      "enum": [
        "bot-researched",
        "verified"
      ]
    },
    "reviewedOn": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "When a person checked the change; null while still bot-researched."
    },
    "slug": {
      "type": "string",
      "description": "The page this change resolves to: a live insurer page for an add, rename or class change, or the former page at the removed row’s own address for a removal."
    },
    "formerSlug": {
      "type": [
        "string",
        "null"
      ],
      "description": "For a rename, the old slug that now carries the former page; null otherwise."
    },
    "group": {
      "type": "string",
      "description": "The ownership group named in the evidence, when given."
    }
  },
  "required": [
    "id",
    "type",
    "date",
    "country",
    "continent",
    "company",
    "evidence",
    "sourceUrl",
    "review",
    "slug"
  ]
}