Land Registry & Title API

How it works

Every official copy follows the same three-step chain. Each call's response carries what you need into the next one.

Real Land Registry requests require an active paid API plan. During your trial, use the free synthetic register extraction test. Other Land Registry requests return 403 with code PAID_API_SUBSCRIPTION_REQUIRED until your paid plan is active.

Send a UPRN where you have one, or a property address and full postcode and we'll resolve the UPRN for you. The response lists candidate titles — take the titleNumber for whichever one matches and use it in step 2.

curl -X POST "https://propertyinsights.co.uk/api/v1/land-registry/title-matches" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  --data '{
  "address": "14 Example Avenue, Exampleton",
  "postcode": "ZZ1 1ZZ"
}'

{
  "success": true,
  "data": {
    "status": "matched",
    "count": 1,
    "titles": [
      {
        "titleNumber": "GR514442",
        "tenure": "Freehold",
        "matchedAddress": "14 Example Avenue, Exampleton, AB1 2CD"
      }
    ]
  }
}

Pass the titleNumber from step 1 to check the title's status, which documents HMLR currently holds, and the exact price for every document combination. Use these prices to set maximumChargePence in step 3.

curl -X GET "https://propertyinsights.co.uk/api/v1/land-registry/titles/GR514442" \
  -H "x-api-key: YOUR_API_KEY"

{
  "success": true,
  "data": {
    "title": { "titleNumber": "GR514442", "status": "VALID", "applicationsPending": false },
    "documents": {
      "register": { "status": "available", "backdated": false },
      "plan": { "status": "available", "backdated": false },
      "referred": []
    },
    "pricing": {
      "currency": "GBP",
      "register": { "totalPence": 700, "totalCredits": 50 },
      "plan": { "totalPence": 700, "totalCredits": 50 },
      "both": { "totalPence": 1400, "totalCredits": 100 },
      "registerWithExtraction": { "totalPence": 700, "totalCredits": 150 },
      "bothWithExtraction": { "totalPence": 1400, "totalCredits": 200 }
    }
  }
}

Step 3

Order the documents

Official-copy purchasing is available automatically with an active paid API plan, sufficient Purchase Balance and API credits. No manual approval is needed. Authorise the exact amount you expect to pay and use a unique Idempotency-Key per order attempt.

curl -X POST "https://propertyinsights.co.uk/api/v1/land-registry/title-orders" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: matter-example-001" \
  -H "content-type: application/json" \
  --data '{
  "titleNumber": "GR514442",
  "documentType": "both",
  "extractRegisterText": true,
  "purchaseAuthorisation": {
    "maximumChargePence": 1400
  }
}'

{
  "success": true,
  "data": {
    "id": "ORDER_UUID",
    "titleNumber": "GR514442",
    "documentType": "both",
    "status": "queued",
    "cost": {
      "totalPence": 1400,
      "paymentStatus": "balance_reserved",
      "totalCredits": 200
    },
    "documents": [],
    "created": true
  }
}

{
  "type": "register",
  "status": "available",
  "downloadUrl": "/api/v1/land-registry/title-orders/ORDER_UUID/documents/register/original",
  "extraction": {
    "status": "ready",
    "text": "A. Property Register ...",
    "data": {
      "title": { "titleNumber": "GR514442", "tenure": "Freehold" },
      "parties": [],
      "rightsAndBurdens": [],
      "referredDocuments": [],
      "enquiries": [],
      "warnings": []
    }
  }
}

Related APIs

Pricing

Title lookups and availability checks use API credits. Official copies use Purchase Balance for the HMLR fee plus API credits for the document and any extraction.

Add funds from the Billing page before placing a live order. A delayed or failed title lookup or availability check is never charged; a delayed lookup returns 503 with retryAfter instead.

All endpoints

Common responses