Property intelligence

Property Profile API

Create a concise property profile with a canonical property identity, registered-title match, legal tenure, property facts, Council Tax and review enquiries.

Endpoint

POST/api/v1/property/profile

A completed request costs 100 credits and requires an API key.

Billing details in the response

Successful chargeable JSON responses include a top-level billing object. The endpoint examples on this page focus on the endpoint-specific data, so this repeated block may not be shown in every example.

"billing": {
  "mode": "prepaid",
  "creditsCharged": 1,
  "creditsRemaining": 1999,
  "creditsRefreshAt": "2026-08-14T09:30:00.000Z"
}

Field or header	Meaning
billing.creditsCharged X-Credits-Charged	Credits charged by this call. Failed and non-chargeable calls return `0` in the header.
billing.creditsRemaining X-Credits-Remaining	The credit balance after the call.
billing.creditsRefreshAt X-Credits-Refresh-At	The next monthly credit refresh as an ISO 8601 timestamp. Trial and non-renewing balances return `null` and omit the header.

All authenticated API-key calls expose the billing headers, including validation errors and zero-credit status or management requests. Only successful chargeable JSON responses add the billing object to the response body.

JSON request body

Field	Required	Description
property.uprn	Conditional	Preferred property identifier. Provide this, or both address and postcode.
property.address	Conditional	Full property address when a UPRN is not supplied.
property.postcode	Conditional	Full Great Britain postcode when an address is supplied.

Geographic availability

Coverage by UK nation

Green: supported Amber: partial Red: not supported

The colour is a geographic coverage indicator, not a risk score. Always inspect source status and completeness in the API response.

England

Supported

HMLR title matching, OS, EPC, Council Tax and Planning Data context are configured.

Wales

Partial

HMLR title matching, OS, EPC and Council Tax context are supported. England-only Planning Data constraints are not returned.

Scotland

Not supported

Registers of Scotland title services are not integrated.

Northern Ireland

Not supported

Land Registry Northern Ireland title services are not integrated.

Example request

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

Example response

{
  "success": true,
  "data": {
    "property": {
      "uprn": "100000000001",
      "address": "14 Example Avenue, Exampleton",
      "postcode": "ZZ1 1ZZ"
    },
    "complete": true,
    "title": {
      "status": "matched",
      "titleNumber": "GR514442",
      "tenure": "Freehold"
    },
    "facts": {
      "legalTenure": "Freehold",
      "propertyType": "House",
      "floorAreaSqM": 96,
      "councilTaxBand": "D",
      "planningConstraintCount": 0
    },
    "manualReviewRequired": false,
    "enquiries": [],
    "unavailable": []
  },
  "billing": {
    "mode": "prepaid",
    "creditsCharged": 100,
    "creditsRemaining": 900,
    "creditsRefreshAt": "2026-09-01T00:00:00.000Z"
  }
}

Important limits

The profile is property intelligence, not an official copy of the register or a legal opinion.
Title matching can return no match, multiple candidates or delayed when HM Land Registry queues the lookup. Delayed responses include reason and retryAfter.
data.complete is false when a source is unavailable. The affected sections are listed in data.unavailable.
EPC occupancy information is not used as evidence of legal tenure.
Floor area can be measured EPC evidence or an OS building estimate. Confirm it against plans or a measured survey before relying on it.