{
  "$id": "https://propertycommons.github.io/property-pack/schema/v1/components.json",
  "$comment": "SPDX-License-Identifier: CC-BY-4.0. A suggested way forward for property packs in England. One worked proposal - not a standard, and endorsed by nobody.",
  "schemaVersion": "ukpp.pack.v1",
  "title": "Property pack component register",
  "description": "One suggested decomposition of an English residential property pack into 27 named components, each with a permanent identifier, a supply code, the best verification level reachable for it today, its expiry semantics, and the primary source it is drawn from.",
  "disclaimer": "This is a suggestion, not a standard. This register is one worked proposal for how a residential property pack in England could be decomposed. No government department, regulator, accreditation body or trade association has endorsed it. Nothing here is required of anyone, and nothing here describes what a property pack will contain - only what one could contain.",
  "jurisdiction": ["england"],
  "checkedBy": "2025code",
  "lastCheckedAt": "2026-08-31",
  "sourceUrlsResolvedAt": "2026-09-08",

  "fieldNotes": {
    "lastCheckedAt": "When the regulatory position recorded in this file was last checked. Inherited from the source analysis and not independently re-verified since.",
    "sourceUrlsResolvedAt": "When every sourceUrl in this file was last confirmed to resolve. A different fact from lastCheckedAt, and deliberately a separate field. Conflating the two is the error this project most wants to avoid.",
    "status": "The legal status of the instrument or source at this row's sourceUrl, as it bears on this component. It is NOT a claim about the status of property pack requirements in general, which are announced-policy throughout. Where a row's source is an operative public dataset rather than a statute, in-force reads as: this source is operative today.",
    "bestVerificationToday": "A ceiling, evaluated today: the highest verification level reachable for this component now, not the level any particular record will carry. Where the ceiling is conditional, verificationNote records the condition.",
    "packSide": "sales for the 21 components of an anticipated sales pack; rental for the 6 components of the landlord-facing evidence set."
  },

  "enums": {
    "supply": {
      "PUB": "Public or open data",
      "OWN": "Owner-declared",
      "PRO": "Requires a paid professional",
      "3P": "Requires a third party to respond"
    },
    "verificationLevel": {
      "ownerDeclared": "The owner typed it. Useful, not authoritative.",
      "sourceMatched": "Matched against a public dataset.",
      "professionallyVerified": "A surveyor, assessor, engineer or installer supplied it.",
      "statutoryRegisterVerified": "Confirmed against a statutory register.",
      "unknown": "Explicitly unknown. A first-class state, not a null."
    },
    "legalStatus": {
      "in-force": "Law today, commenced, enforceable - or, for a dataset, operative today.",
      "enacted-not-commenced": "On the statute book, awaiting commencement regulations.",
      "announced-policy": "Government has stated intent; requires future legislation.",
      "consultation-stage": "Consultation announced or open; content not settled.",
      "locally-discretionary": "Exists, but varies by local authority and date."
    },
    "expiryKind": {
      "stable": "Does not expire in normal circumstances.",
      "hard": "A dated expiry on the face of the document or certificate.",
      "soft": "No legal expiry, but treated as stale after a conventional period.",
      "periodic": "Reviewed or reissued on a cycle.",
      "append-only": "Never expires; new entries are appended.",
      "on-change": "Valid until the underlying fact changes.",
      "volatile": "Goes stale in days.",
      "point-in-time": "A snapshot, valid only for the moment it describes.",
      "per-event": "Tied to a transaction, tenancy or registration rather than to a date."
    },
    "mvpPrefill": {
      "yes": "Can be pre-filled free from public data.",
      "partly": "Can be partly pre-filled, or pre-filled but requiring owner confirmation.",
      "no": "Cannot be pre-filled; supplied by the owner, a professional or a third party.",
      "not-yet": "The source is not operational yet. Build the fields, flag them off."
    },
    "packSide": {
      "sales": "Part of an anticipated sales pack.",
      "rental": "Part of the landlord-facing rental evidence set."
    }
  },

  "notes": [
    {
      "id": "unreachable-verification-state",
      "note": "statutoryRegisterVerified is reachable by no row in this register today, and is retained deliberately. The enum describes kinds of evidence, not available feeds. It remains the correct label for the PRS Database the day that register becomes operational, and removing it now would mean a breaking change to a published interchange format then. An unused enum value costs nothing; an absent one costs a breaking change."
    },
    {
      "id": "licensing-is-address-specific",
      "note": "licensing-status is locally-discretionary. Selective, additional and mandatory HMO licensing designations are made council by council. For most addresses no curated register exists, and the honest output is uncertain plus a link to the relevant council - not a guess."
    },
    {
      "id": "coverage-arithmetic",
      "note": "Of the 21 sales-side components, 9 are pre-fillable free from public data, 6 are owner-supplied, 4 need a paid professional and 2 need a third party to respond. The 6 that cannot be self-supplied stay in any completeness denominator rather than being excluded to flatter the total."
    }
  ],

  "components": [
    {
      "id": "address-uprn",
      "ordinal": 1,
      "name": "Address and UPRN",
      "supply": ["PUB"],
      "source": "Address data, Unique Property Reference Number",
      "bestVerificationToday": "sourceMatched",
      "verificationNote": null,
      "expiry": { "kind": "stable", "note": null },
      "mvpPrefill": "yes",
      "packSide": "sales",
      "sourceUrl": "https://www.geoplace.co.uk/addresses/uprn",
      "status": "in-force",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "property-type",
      "ordinal": 2,
      "name": "Property type",
      "supply": ["PUB", "OWN"],
      "source": "Open data, confirmed by the owner",
      "bestVerificationToday": "sourceMatched",
      "verificationNote": null,
      "expiry": { "kind": "stable", "note": null },
      "mvpPrefill": "yes",
      "packSide": "sales",
      "sourceUrl": "https://epc.opendatacommunities.org/",
      "status": "in-force",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "tenure",
      "ordinal": 3,
      "name": "Tenure",
      "supply": ["PUB", "OWN"],
      "source": "HM Land Registry title, or owner declaration",
      "bestVerificationToday": "sourceMatched",
      "verificationNote": "sourceMatched only from a paid title. Without one the honest level is ownerDeclared, and it must be shown as such.",
      "expiry": { "kind": "stable", "note": null },
      "mvpPrefill": "partly",
      "packSide": "sales",
      "sourceUrl": "https://www.gov.uk/search-property-information-land-registry",
      "status": "in-force",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "council-tax-band",
      "ordinal": 4,
      "name": "Council tax band",
      "supply": ["PUB"],
      "source": "Valuation Office Agency",
      "bestVerificationToday": "sourceMatched",
      "verificationNote": null,
      "expiry": { "kind": "periodic", "note": "Annual review" },
      "mvpPrefill": "yes",
      "packSide": "sales",
      "sourceUrl": "https://www.tax.service.gov.uk/check-council-tax-band/search",
      "status": "in-force",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "epc",
      "ordinal": 5,
      "name": "Energy Performance Certificate",
      "supply": ["PUB"],
      "source": "EPC open data",
      "bestVerificationToday": "sourceMatched",
      "verificationNote": null,
      "expiry": { "kind": "hard", "note": "Certificate expiry date" },
      "mvpPrefill": "yes",
      "packSide": "sales",
      "sourceUrl": "https://epc.opendatacommunities.org/",
      "status": "in-force",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "planning-history",
      "ordinal": 6,
      "name": "Planning history",
      "supply": ["PUB"],
      "source": "Planning Data platform and local planning authority records",
      "bestVerificationToday": "sourceMatched",
      "verificationNote": null,
      "expiry": { "kind": "append-only", "note": null },
      "mvpPrefill": "partly",
      "packSide": "sales",
      "sourceUrl": "https://www.planning.data.gov.uk/",
      "status": "in-force",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "heritage-designations",
      "ordinal": 7,
      "name": "Listed building, conservation area and Article 4 designations",
      "supply": ["PUB"],
      "source": "Planning Data platform",
      "bestVerificationToday": "sourceMatched",
      "verificationNote": null,
      "expiry": { "kind": "on-change", "note": "Designations change" },
      "mvpPrefill": "yes",
      "packSide": "sales",
      "sourceUrl": "https://www.planning.data.gov.uk/",
      "status": "in-force",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "flood-risk",
      "ordinal": 8,
      "name": "Flood risk",
      "supply": ["PUB"],
      "source": "Long term flood risk service",
      "bestVerificationToday": "sourceMatched",
      "verificationNote": null,
      "expiry": { "kind": "periodic", "note": "Periodic refresh" },
      "mvpPrefill": "yes",
      "packSide": "sales",
      "sourceUrl": "https://check-long-term-flood-risk.service.gov.uk/",
      "status": "in-force",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "price-paid-history",
      "ordinal": 9,
      "name": "Price paid history",
      "supply": ["PUB"],
      "source": "HM Land Registry Price Paid Data",
      "bestVerificationToday": "sourceMatched",
      "verificationNote": null,
      "expiry": { "kind": "append-only", "note": null },
      "mvpPrefill": "yes",
      "packSide": "sales",
      "sourceUrl": "https://landregistry.data.gov.uk/app/ppd",
      "status": "in-force",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "heating-type",
      "ordinal": 10,
      "name": "Heating type",
      "supply": ["OWN"],
      "source": "Owner, cross-checked against the EPC",
      "bestVerificationToday": "ownerDeclared",
      "verificationNote": null,
      "expiry": { "kind": "on-change", "note": null },
      "mvpPrefill": "partly",
      "packSide": "sales",
      "sourceUrl": "https://epc.opendatacommunities.org/",
      "status": "in-force",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "utilities",
      "ordinal": 11,
      "name": "Utilities: water, sewerage, electricity",
      "supply": ["OWN"],
      "source": "Owner",
      "bestVerificationToday": "ownerDeclared",
      "verificationNote": null,
      "expiry": { "kind": "on-change", "note": null },
      "mvpPrefill": "no",
      "packSide": "sales",
      "sourceUrl": "https://www.gov.uk/government/consultations/home-buying-and-selling-reform/outcome/home-buying-and-selling-reform-roadmap",
      "status": "announced-policy",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "parking",
      "ordinal": 12,
      "name": "Parking",
      "supply": ["OWN"],
      "source": "Owner",
      "bestVerificationToday": "ownerDeclared",
      "verificationNote": null,
      "expiry": { "kind": "on-change", "note": null },
      "mvpPrefill": "no",
      "packSide": "sales",
      "sourceUrl": "https://www.gov.uk/government/consultations/home-buying-and-selling-reform/outcome/home-buying-and-selling-reform-roadmap",
      "status": "announced-policy",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "general-property-information",
      "ordinal": 13,
      "name": "General property information",
      "supply": ["OWN"],
      "source": "Owner: alterations, guarantees, disputes, boundaries, occupiers",
      "bestVerificationToday": "ownerDeclared",
      "verificationNote": null,
      "expiry": { "kind": "on-change", "note": null },
      "mvpPrefill": "no",
      "packSide": "sales",
      "sourceUrl": "https://www.gov.uk/government/consultations/home-buying-and-selling-reform/outcome/home-buying-and-selling-reform-roadmap",
      "status": "announced-policy",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "rights-easements",
      "ordinal": 14,
      "name": "Rights and easements",
      "supply": ["OWN", "PRO"],
      "source": "Owner knowledge, confirmed on title",
      "bestVerificationToday": "ownerDeclared",
      "verificationNote": null,
      "expiry": { "kind": "stable", "note": null },
      "mvpPrefill": "no",
      "packSide": "sales",
      "sourceUrl": "https://www.gov.uk/search-property-information-land-registry",
      "status": "in-force",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "chain-status",
      "ordinal": 15,
      "name": "Chain status",
      "supply": ["OWN"],
      "source": "Seller",
      "bestVerificationToday": "ownerDeclared",
      "verificationNote": null,
      "expiry": { "kind": "volatile", "note": "Goes stale in days. A stale chain status is worse than none." },
      "mvpPrefill": "no",
      "packSide": "sales",
      "sourceUrl": "https://www.gov.uk/government/consultations/home-buying-and-selling-reform/outcome/home-buying-and-selling-reform-roadmap",
      "status": "announced-policy",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "hmlr-title",
      "ordinal": 16,
      "name": "HM Land Registry title information and documents",
      "supply": ["PRO"],
      "source": "HM Land Registry",
      "bestVerificationToday": "sourceMatched",
      "verificationNote": "sourceMatched once the title has been obtained. It is a paid item.",
      "expiry": { "kind": "on-change", "note": "On dealing" },
      "mvpPrefill": "no",
      "packSide": "sales",
      "sourceUrl": "https://www.gov.uk/guidance/hm-land-registry-information-services",
      "status": "in-force",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "standard-searches",
      "ordinal": 17,
      "name": "Standard searches: local authority, environmental, drainage and water",
      "supply": ["PRO"],
      "source": "Search providers",
      "bestVerificationToday": "professionallyVerified",
      "verificationNote": null,
      "expiry": { "kind": "soft", "note": "Typically treated as stale after about six months for lender purposes" },
      "mvpPrefill": "no",
      "packSide": "sales",
      "sourceUrl": "https://www.gov.uk/government/consultations/home-buying-and-selling-reform/outcome/home-buying-and-selling-reform-roadmap",
      "status": "announced-policy",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "property-condition-report",
      "ordinal": 18,
      "name": "Property condition report",
      "supply": ["PRO"],
      "source": "Surveyor, tailored to the age and type of the property",
      "bestVerificationToday": "professionallyVerified",
      "verificationNote": null,
      "expiry": { "kind": "point-in-time", "note": null },
      "mvpPrefill": "no",
      "packSide": "sales",
      "sourceUrl": "https://www.gov.uk/government/consultations/home-buying-and-selling-reform/outcome/home-buying-and-selling-reform-roadmap",
      "status": "announced-policy",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "seller-identity-verification",
      "ordinal": 19,
      "name": "Seller identity verification",
      "supply": ["PRO"],
      "source": "A certified digital identity service provider",
      "bestVerificationToday": "professionallyVerified",
      "verificationNote": null,
      "expiry": { "kind": "per-event", "note": "Per transaction" },
      "mvpPrefill": "no",
      "packSide": "sales",
      "sourceUrl": "https://www.gov.uk/government/collections/uk-digital-identity-and-attributes-trust-framework",
      "status": "announced-policy",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "leasehold-terms",
      "ordinal": 20,
      "name": "Leasehold and freehold estate terms",
      "supply": ["3P"],
      "source": "Freeholder or managing agent: service charge, ground rent, estate rent charge, managed freehold charges",
      "bestVerificationToday": "professionallyVerified",
      "verificationNote": "professionallyVerified on a response from the freeholder or managing agent. From documents the owner already holds, the honest level is ownerDeclared.",
      "expiry": { "kind": "periodic", "note": "Annual, on budget cycles" },
      "mvpPrefill": "no",
      "packSide": "sales",
      "sourceUrl": "https://www.legislation.gov.uk/ukpga/2024/22/contents",
      "status": "enacted-not-commenced",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "building-safety-information",
      "ordinal": 21,
      "name": "Building safety information",
      "supply": ["3P"],
      "source": "Building owner or principal accountable person",
      "bestVerificationToday": "professionallyVerified",
      "verificationNote": "professionallyVerified on a response. Applies to in-scope buildings.",
      "expiry": { "kind": "on-change", "note": null },
      "mvpPrefill": "no",
      "packSide": "sales",
      "sourceUrl": "https://www.legislation.gov.uk/ukpga/2022/30/contents",
      "status": "in-force",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "gas-safety-record",
      "ordinal": 22,
      "name": "Gas safety record",
      "supply": ["OWN"],
      "source": "A registered engineer, via the document the landlord holds",
      "bestVerificationToday": "professionallyVerified",
      "verificationNote": "The document was produced by a professional. The claim that it is genuine and belongs to this property is the uploader's.",
      "expiry": { "kind": "hard", "note": "12 months" },
      "mvpPrefill": "no",
      "packSide": "rental",
      "sourceUrl": "https://www.legislation.gov.uk/uksi/1998/2451/contents",
      "status": "in-force",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "eicr",
      "ordinal": 23,
      "name": "Electrical Installation Condition Report",
      "supply": ["OWN"],
      "source": "A qualified electrician, via the document the landlord holds",
      "bestVerificationToday": "professionallyVerified",
      "verificationNote": "The document was produced by a professional. The claim that it is genuine and belongs to this property is the uploader's.",
      "expiry": { "kind": "hard", "note": "5 years" },
      "mvpPrefill": "no",
      "packSide": "rental",
      "sourceUrl": "https://www.legislation.gov.uk/uksi/2020/312/contents",
      "status": "in-force",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "alarms-co-declaration",
      "ordinal": 24,
      "name": "Smoke and carbon monoxide alarm declaration",
      "supply": ["OWN"],
      "source": "Landlord",
      "bestVerificationToday": "ownerDeclared",
      "verificationNote": null,
      "expiry": { "kind": "periodic", "note": null },
      "mvpPrefill": "no",
      "packSide": "rental",
      "sourceUrl": "https://www.legislation.gov.uk/uksi/2015/1693/contents",
      "status": "in-force",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "licensing-status",
      "ordinal": 25,
      "name": "Property licensing status",
      "supply": ["PUB"],
      "source": "Local authority licensing designations",
      "bestVerificationToday": "sourceMatched",
      "verificationNote": "sourceMatched only where a council publishes a curated register. For most addresses no such register exists, and the honest output is uncertain plus a link to the relevant council.",
      "expiry": { "kind": "periodic", "note": "Designation term" },
      "mvpPrefill": "partly",
      "packSide": "rental",
      "sourceUrl": "https://www.legislation.gov.uk/ukpga/2004/34/part/3",
      "status": "locally-discretionary",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "written-statement-of-terms",
      "ordinal": 26,
      "name": "Written statement of terms",
      "supply": ["OWN"],
      "source": "Landlord",
      "bestVerificationToday": "ownerDeclared",
      "verificationNote": null,
      "expiry": { "kind": "per-event", "note": "Per tenancy" },
      "mvpPrefill": "no",
      "packSide": "rental",
      "sourceUrl": "https://www.legislation.gov.uk/ukpga/2025/26/contents",
      "status": "in-force",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    },
    {
      "id": "prs-database-ids",
      "ordinal": 27,
      "name": "Private rented sector database landlord and dwelling identifiers",
      "supply": ["PUB"],
      "source": "The private rented sector database",
      "bestVerificationToday": "unknown",
      "verificationNote": "The register is not operational, so no verification level above unknown is reachable for this component today. It would become statutoryRegisterVerified once the database is live - the only row in this register that could ever reach that level at present.",
      "expiry": { "kind": "per-event", "note": "Per registration" },
      "mvpPrefill": "not-yet",
      "packSide": "rental",
      "sourceUrl": "https://www.legislation.gov.uk/ukpga/2025/26/contents",
      "status": "enacted-not-commenced",
      "checkedBy": "2025code",
      "lastCheckedAt": "2026-08-31",
      "jurisdiction": ["england"]
    }
  ]
}