Land Registry Ownership Verification

We offer two variables that allow customers to verify the ownership of properties via HMLR. If you would like access to these variables please contact us.

Postal Address Variable

The first of these variables is available on the Postal Address ResourceCatalog and takes three inputs, forename, an optional middleName, and surname, for example:

Request:

POST /world/GB/addresses/8e05p%C2%B70/catalog HTTP/1.1
Host: api.whenfresh.com
Authorization: Bearer [YOUR_ACCESS_TOKEN]
Content-Type: application/ld+json
Accept: application/ld+json

{
  "@context": "http://api.whenfresh.com/.hydra/context.jsonld",
  "@type": "PurchaseVariableAction",
  "variables": [
    {
      "@id": "https://api.whenfresh.com/vars/Land Registry/Ownership Verification (Postal Address)#Property/Title/Ownership/Ownership Verification",
      "forename": "Arthur",
      "middleName": "Conan", // Optional
      "surname": "Doyle"
    }
  ]
}

Postcode Variable

The second of these variables is available on the Postcode ResourceCatalog. It takes the same inputs as above, but also an additional string for the address, for example:

Request:

POST /world/GB/postcodes/NW1%206XE/catalog HTTP/1.1
Host: api.whenfresh.com
Authorization: Bearer [YOUR_ACCESS_TOKEN]
Content-Type: application/ld+json
Accept: application/ld+json

{
  "@context": "http://api.whenfresh.com/.hydra/context.jsonld",
  "@type": "PurchaseVariableAction",
  "variables": [
    {
      "@id": "https://api.whenfresh.com/vars/Land Registry/Ownership Verification (Postcode)#Property/Title/Ownership/Ownership Verification",
      "forename": "Arthur",
      "middleName": "Conan",
      "surname": "Doyle", // Optional
      "address": "221B Baker Street"
    }
  ]
}

Example Response

The response is the same structure irrespective of which variable you choose to use above. An example is shown below.

There are four values that can be returned by the variable, NO_MATCHES, SINGLE_MATCH, MULTIPLE_MATCHES, or INCONCLUSIVE and the accompanying valueReference section will contain data relating to the match.

In the case of MULTIPLE_MATCHES the member array will contain multiple entries.

Response:

{
    "@context": "https://api.whenfresh.com/.hydra/context.jsonld",
    "@type": "ResourceCatalogPurchase",
    "manages": {
        "property": "rdf:type",
        "object": "Datum"
    },
    "member": [
        {
            "@type": "https://api.whenfresh.com/ontologies/Property/Title#Ownership/Ownership Verification",
            "price": {
                "@type": "MonetaryAmount",
                "currency": "GBP",
                "value": 0.65
            },
            "value": "SINGLE_MATCH",
            "valueReference": [
                {
                    "@type": "https://api.whenfresh.com/ontologies/Property/Title#Ownership/Forename Match",
                    "value": "MATCH",
                    "variable": {
                        "@id": "https://api.whenfresh.com/vars/Land Registry/Ownership Verification#Property/Title/Ownership/Forename Match",
                        "@type": "Variable"
                    }
                },
                {
                    "@type": "https://api.whenfresh.com/ontologies/Property/Title#Ownership/Middlename Match",
                    "value": "MATCH",
                    "variable": {
                        "@id": "https://api.whenfresh.com/vars/Land Registry/Ownership Verification#Property/Title/Ownership/Middlename Match",
                        "@type": "Variable"
                    }
                },
                {
                    "@type": "https://api.whenfresh.com/ontologies/Property/Title#Ownership/Surname Match",
                    "value": "MATCH",
                    "variable": {
                        "@id": "https://api.whenfresh.com/vars/Land Registry/Ownership Verification#Property/Title/Ownership/Surname Match",
                        "@type": "Variable"
                    }
                },
                {
                    "@type": "https://api.whenfresh.com/ontologies/Property/Title#Ownership/Historical Match",
                    "value": "true",
                    "variable": {
                        "@id": "https://api.whenfresh.com/vars/Land Registry/Ownership Verification#Property/Title/Ownership/Historical Match",
                        "@type": "Variable"
                    }
                },
                {
                    "@type": "https://api.whenfresh.com/ontologies/Property/Title#Ownership/Ownership",
                    "value": "Joint",
                    "variable": {
                        "@id": "https://api.whenfresh.com/vars/Land Registry/Ownership Verification#Property/Title/Ownership/Ownership",
                        "@type": "Variable"
                    }
                },
                {
                    "@type": "https://api.whenfresh.com/ontologies/Property/Title#Ownership/Proprietor From",
                    "value": "22 May 1859",
                    "variable": {
                        "@id": "https://api.whenfresh.com/vars/Land Registry/Ownership Verification#Property/Title/Ownership/Proprietor From",
                        "@type": "Variable"
                    }
                },
                {
                    "@type": "https://api.whenfresh.com/ontologies/Property/Title#Ownership/Proprietor To",
                    "value": "07 Jul 1930",
                    "variable": {
                        "@id": "https://api.whenfresh.com/vars/Land Registry/Ownership Verification (Postcode)#Property/Title/Ownership/Proprietor To",
                        "@type": "Variable"
                    }
                },
                {
                    "@type": "https://api.whenfresh.com/ontologies/Property/Title#Ownership/Property Title Number",
                    "value": "ACD221BBSL",
                    "variable": {
                        "@id": "https://api.whenfresh.com/vars/Land Registry/Owner Verification#Property/Title/Ownership/Property Title Number",
                        "@type": "Variable"
                    }
                },
                {
                    "@type": "https://api.whenfresh.com/ontologies/Property/Title#Ownership/Property Title Class",
                    "value": "freehold",
                    "variable": {
                        "@id": "https://api.whenfresh.com/vars/Land Registry/Owner Verification#Property/Title/Ownership/Property Title Class",
                        "@type": "Variable"
                    }
                },
                {
                    "@type": "https://api.whenfresh.com/ontologies/Royal Mail/Postal Address File#Postal Address/Building Name",
                    "value": "221B",
                    "variable": {
                        "@id": "https://api.whenfresh.com/vars/Land Registry/Owner Verification#Royal Mail/Postal Address File/Postal Address/Building Name",
                        "@type": "Variable"
                    }
                },
                {
                    "@type": "https://api.whenfresh.com/ontologies/Royal Mail/Postal Address File#Postal Address/Thoroughfare Name",
                    "value": "BAKER STREET",
                    "variable": {
                        "@id": "https://api.whenfresh.com/vars/Land Registry/Owner Verification#Royal Mail/Postal Address File/Postal Address/Thoroughfare Name",
                        "@type": "Variable"
                    }
                },
                {
                    "@type": "https://api.whenfresh.com/ontologies/Royal Mail/Postal Address File#Postal Address/Postal Town",
                    "value": "LONDON",
                    "variable": {
                        "@id": "https://api.whenfresh.com/vars/Land Registry/Owner Verification#Royal Mail/Postal Address File/Postal Address/Postal Town",
                        "@type": "Variable"
                    }
                },
                {
                    "@type": "https://api.whenfresh.com/ontologies/Royal Mail/Postal Address File#Postal Address/Postcode",
                    "value": "NW1 6XE",
                    "variable": {
                        "@id": "https://api.whenfresh.com/vars/Land Registry/Owner Verification#Royal Mail/Postal Address File/Postal Address/Postcode",
                        "@type": "Variable"
                    }
                }
            ],
            "variable": {
                "@id": "https://api.whenfresh.com/vars/Land Registry/Ownership Verification#Property/Title/Ownership/Ownership Verification",
                "@type": "Variable"
            }
        }
    ],
    "totalItems": 1
}

If a current match based on the details you pass cannot be found, but the details you pass match some historical ownership of the property, you will get back that historical ownership in the response. You can differentiate a current match from a historical match using the Historical Match flag (shown in the response above). In the case of a historical match you will get back Proprietor From and Proprietor To dates. These are not returned for current matches.