England
SupportedHMLR title matching, OS, EPC, Council Tax and Planning Data context are configured.
Property intelligence
Create a concise property profile with a canonical property identity, registered-title match, legal tenure, property facts, Council Tax and review enquiries. Use it as a property information API when you need one summary per address.
/api/v1/property/profileA completed request costs 100 credits and requires an API key. Use ?with= to request only the sections you need and pay less.
?with= Pass a comma-separated list, for example /api/v1/property/profile?with=epc,councilTax. Every request with with costs 20 credits for the address match, facts and enquiries, plus the sections you list. Leave it out to get every section except planningApplications for 100 credits.
| Section | Credits | Adds |
|---|---|---|
| title | 25 | data.title, legal tenure, registered area and title enquiries. |
| building | 35 | data.building with OS building facts such as floors and age, footprint area, heights, roof shape, material and area by aspect, and an indicative solar rating. |
| epc | 5 | EPC property type, built form and measured floor area. |
| councilTax | 10 | Council Tax band. |
| planningConstraints | 5 | Planning constraint count and the constraint enquiry. |
| planningApplications | 5 | Beta, only when requested. Planning applications whose address matches the property by text and location, not UPRN, with council coverage. See the Planning Applications API for caveats. |
An unknown section returns HTTP 400 with INVALID_WITH and no charge. Sections you leave out are not fetched and do not appear in data.unavailable.
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.
If your balance is lower than the cost of a request, the API returns HTTP 402 and charges nothing. The error includes the credits needed, your balance and a link to change plan.
{
"statusCode": 402,
"statusMessage": "Payment Required",
"data": {
"success": false,
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "This request costs 35 API credits. Upgrade your plan or wait for your monthly refresh: https://propertyinsights.co.uk/billing",
"required": 35,
"available": 12,
"upgradeUrl": "https://propertyinsights.co.uk/billing"
}
}
}| 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
The colour is a geographic coverage indicator, not a risk score. Always inspect source status and completeness in the API response.
HMLR title matching, OS, EPC, Council Tax and Planning Data context are configured.
HMLR title matching, OS, EPC and Council Tax context are supported. England-only Planning Data constraints are not returned.
Land Register of Scotland title number from the ScotLIS search, Registers of Scotland INSPIRE parcel extent, OS, Scottish EPC, Council Tax and Scottish planning designations. Tenure is not returned and Sasine Register properties have no title match.
Land Registry Northern Ireland title services are not integrated.
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"
}
}'{
"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",
"tenureSource": "title",
"propertyType": "House",
"floorAreaSqM": 96,
"councilTaxBand": "D",
"planningConstraintCount": 0
},
"building": {
"builtForm": "Semi-Detached",
"constructionMaterial": "Brick Or Block Or Stone",
"footprint": {
"areaM2": 58.4,
"buildingPartCount": 1
},
"height": {
"relativeMaxM": 8.6,
"relativeRoofBaseM": 5.4,
"confidence": "Moderate"
},
"roof": {
"shape": "Pitched",
"material": "Tile Or Stone Or Slate",
"solarPanels": "Not Present",
"totalAreaM2": 68.2,
"pitchedAreaM2": 68.2,
"flatAreaM2": 0,
"pitchedAreaByAspectM2": {
"north": 34.1,
"northEast": 0,
"east": 0,
"southEast": 0,
"south": 34.1,
"southWest": 0,
"west": 0,
"northWest": 0,
"indeterminable": 0
},
"solarSuitability": {
"rating": "good",
"suitableAreaM2": 34.1,
"southFacingPitchedAreaM2": 34.1,
"flatAreaM2": 0,
"indicative": true
}
}
},
"manualReviewRequired": false,
"enquiries": [],
"unavailable": []
},
"billing": {
"mode": "prepaid",
"creditsCharged": 100,
"creditsRemaining": 900,
"creditsRefreshAt": "2026-09-01T00:00:00.000Z"
}
}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.facts.legalTenure uses the tenure on the address's most recent Land Registry sale. facts.tenureSource is then price_paid and facts.tenureAsOf is the sale date. A lease may have been extended, or the freehold bought, since that sale.roof.solarSuitability is indicative, not a survey. It adds south, south-east and south-west pitched roof area to flat roof area: 20 m2 or more is good, 10 m2 or more is moderate, anything less is limited. It does not account for shading, structure or planning rules.