Obtain HMLR Title Numbers for a UPRN

The following request demonstrates how to purchase the HMLR Title Numbers registered against a property, when you have a UPRN (e.g. 10003879884) in hand.

Request:

POST /world/GB/uprns/10003879884/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": [
    "https://api.whenfresh.com/vars/Land Registry/NPS#Property/Title/Ownership/Property Title Number"
  ]
}

Response:

{
  "@context": "https://api.whenfresh.com/.hydra/context.jsonld",
  "@id": "https://api.whenfresh.com/purchases/a39d92dc-fb5e-4502-8ad4-831cc264eb3b",
  "@type": "ResourceCatalogPurchase",
  "manages": {
    "property": "rdf:type",
    "object": "Datum"
  },
  "member": [
    {
      "@type": "https://api.whenfresh.com/ontologies/Property/Title#Ownership/Property Title Number",
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "Class of Title Code",
          "value": "AF"
        },
        {
          "@type": "PropertyValue",
          "name": "Title UPRN Count",
          "value": "15"
        }
      ],
      "day": "2026-07-01",
      "modified": "2026-07-08T20:59:43+00:00",
      "price": {
        "@type": "MonetaryAmount",
        "currency": "GBP",
        "value": 0.10
      },
      "value": "SK303510",
      "variable": {
        "@id": "https://api.whenfresh.com/vars/Land Registry/NPS#Property/Title/Ownership/Property Title Number",
        "@type": "Variable"
      }
    },
    {
      "@type": "https://api.whenfresh.com/ontologies/Property/Title#Ownership/Property Title Number",
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "Class of Title Code",
          "value": "AL"
        },
        {
          "@type": "PropertyValue",
          "name": "Title UPRN Count",
          "value": "1"
        }
      ],
      "day": "2026-07-01",
      "modified": "2026-07-08T20:59:43+00:00",
      "price": {
        "@type": "MonetaryAmount",
        "currency": "GBP",
        "value": 0.10
      },
      "value": "SK318450",
      "variable": {
        "@id": "https://api.whenfresh.com/vars/Land Registry/NPS#Property/Title/Ownership/Property Title Number",
        "@type": "Variable"
      }
    }
  ],
  "processingFee": {
    "@type": "MonetaryAmount",
    "currency": "GBP",
    "value": 0
  },
  "totalItems": 2
}

A UPRN can have more than one Title Number registered against it, so the member array may contain multiple entries — one per title. In the example above, the property has both a freehold title (SK303510) and a leasehold title (SK318450), which is typical of a leasehold flat: the leasehold title covers the flat itself, while the freehold title covers the building it sits in.

Each entry carries the Title Number in value, and two additionalProperty values that describe the title:

Class of Title Code

The class of title assigned by HMLR, combined with the tenure. The first letter indicates the class (Absolute, Good, Possessory or Qualified) and the second the tenure (Freehold, Leasehold or Rentcharge):

Code	Meaning
AF	Absolute Freehold
AL	Absolute Leasehold
AR	Absolute Rentcharge
CN	Commonhold
GL	Good Leasehold
PF	Possessory Freehold
PL	Possessory Leasehold
PR	Possessory Rentcharge
QF	Qualified Freehold
QL	Qualified Leasehold
QR	Qualified Rentcharge

The code may also be blank, where HMLR has not recorded a class of title.

Title UPRN Count

The number of UPRNs associated with the title. Use this to determine whether the Title Number applies to just the UPRN you queried, or to other UPRNs too:

• A count of 1 means the title relates solely to this UPRN.
• A count greater than 1 means the title also covers other UPRNs. In the example above, the freehold title SK303510 has a count of 15 — it covers the whole building containing 15 addressable properties — whereas the leasehold title SK318450 has a count of 1 and applies to this flat alone.