Full property record
property_lookupEverything the platform holds about one UPRN, grouped into tiers, up to about three hundred fields, each with a source and a confidence beside it.
Same call over REST
Property lookup/v1/property/{uprn}Not connected yet? Connect your assistant. Sign in with your MarketCode account; no API key needed.
Reference
What property_lookup answers
The whole record. Ten tiers: identity, property, energy, building, land, risk, designations, infrastructure, ownership and provenance. Null fields are omitted, so a typical urban flat returns fewer fields than a rural site with designations on it, and the count of fields is itself informative.
The provenance tier is the reason this exists as one call. For every populated field there is a <field>_source and a <field>_confidence sibling, so a reader can trust a cell rather than a row: the floor area from a certificate and the floor area from measured geometry are the same field with different provenance, and a downstream decision can weight them differently. It costs 5 credits because the record carries licensed AddressBase, building and ownership data.
Reference
When to use it, and when not to
Use it when you want everything about a property in one place: a due diligence report, a lender's file, a data pipeline that joins to its own systems. For a quick orientation use property_summary (4 credits); for a value with its evidence use valuation_full (free); where sources disagree, property_reconcile surfaces the divergence across EPC, the portals, council tax and Ordnance Survey rather than picking a winner silently.
Inputs
Before you call it
A UPRN. address_autocomplete (free) then address_resolve (8 credits) gets you one from an address.
- uprn
- A UPRN is the Unique Property Reference Number every UK address carries. Narrow the address with address_autocomplete, which is free, then address_resolve returns the UPRN for 8 credits. property_summary and address_by_postcode return UPRNs too.
Inputs
Arguments property_lookup takes
| Name | Type | Required | Description |
|---|---|---|---|
| uprn | string | Yes |
Reference
Things that catch people out
- Read the provenance before the value. Two properties can show the same floor area with different confidence; the source sibling says why. A report that quotes a field should quote its source.
- Omitted is unknown, not zero. A field with no value is left out. A flat with no
garden_areahas not been measured as having none. - Ownership names companies, not people. The ownership tier comes from the bulk HM Land Registry registers, which cover companies, public bodies and overseas entities. An individually owned title shows no proprietor here; that is a gap in the free register, not a finding.
- Designations are England. The designations tier reads planning.data.gov.uk, which covers England; a Welsh property's tier is sparse for that reason.
Usage
How to run property_lookup in your assistant
Ask your assistant in plain English, for example:
"Use the MarketCode tool property_lookup for <address or area>.
Show the result and the credits charged."The connect steps for Claude, ChatGPT, Codex, Cursor and Claude Code are on the MCP page.
Skills
Skills that use property_lookup
- Property research: A sourced answer to any UK property question: the right tool for the job, the credit cost stated first, the wording rules that keep an estimate an estimate.
- Due diligence report: A property due diligence report: title and ownership, history, EPC and council tax, flood and designations, nearby activity, cross-source disagreements and the cross-reference findings that join them, with a traffic light.
Price and licence
What it costs, and where the data comes from
property_lookup costs 5 credits per successful call over MCP and over REST, and the two surfaces share one credit balance.
The price covers licensed records in the response, from HM Land Registry, Ordnance Survey, Valuation Office Agency and Ministry of Housing, Communities and Local Government. A call that fails is not charged.
Credits are granted on sign-up and bought in packs; the pricing page lists every call.
Sources
- HM Land Registry
Commercial and Corporate Ownership (CCOD) and Overseas Companies Ownership (OCOD)
HM Land Registry's dataset licence for CCOD and OCOD: free of charge, with conditions on onward use · England and Wales
- Ordnance Survey
AddressBase
Used under licence from Ordnance Survey · Great Britain
- Ordnance Survey
National Geographic Database (buildings, land and sites)
Used under licence from Ordnance Survey · Great Britain
- Valuation Office Agency
Council tax valuation list
Crown copyright · England and Wales
- Ministry of Housing, Communities and Local Government
Energy Performance Certificates (domestic and non-domestic)
MHCLG's EPC open data terms · England and Wales
Related
Tools used with property_lookup
- Property summary4 credits
property_summaryOne-call summary of a property: what it is, what building it belongs to,Pairs with this - Reconcile a property across sources3 credits
property_reconcileCross-source feature reconciliation for a UPRN — surfaces divergencePairs with this - Full valuation with back-seriesFree
valuation_fullFull valuation block for a property: the value and its range, a monthlyPairs with this - Registered proprietors of a title3 credits
ownership_by_titleRegistered proprietor(s) for an HMLR title number.Pairs with this - EPC certificates for a propertyFree
epc_certificatesEvery Energy Performance Certificate lodged against a property, newest first, with current and potential efficiency, CO2, heating fuel and system, floor area and construction age.Pairs with this - Commercial property report: RV, indexes, yield, owner2 credits
commercial_propertyThe commercial property report, by UPRN or by VOA UARN: the hereditament as the 2026 rating list describes it (rateable value, sector, description), the sector's rent index across the 2010/2017/2023/2026 lists and its capital index (national, plus the local authority where one exists), an income-basis value that capitalises the RV at the district's commercial auction net yield — with the yield's receipt, and `not_available` where the district published none — the auction history at the address, the district's commercial auction market by quarter, the registered owner and the lease. Blocks that cannot be derived today say `not_available` with the reason (the RV history per hereditament; the VOA measured area). RV is a rating measure at the antecedent valuation date, not passing rent — say so when you quote the income-basis figure. UK only.Same category
Glossary
Terms used here
- Floor area: The internal area of a property in square metres, taken from its energy certificate or measured from building geometry; the input the valuation model cannot do without.
- Title number: HM Land Registry's identifier for a registered title: a prefix for the office and a number, such as TGL123456; the key ownership records are held against.
FAQ
Questions about property_lookup
How much does `property_lookup` cost?
+
property_lookup costs 5 credits per successful call over MCP and over REST, and the two surfaces share one credit balance. The price covers licensed records in the response, from HM Land Registry, Ordnance Survey, Valuation Office Agency and Ministry of Housing, Communities and Local Government. A call that fails is not charged.
Do I need to resolve the address first?
+
Yes. property_lookup takes a UPRN, not an address. Start with address_autocomplete (free) to narrow the address, then address_resolve (8 credits) to get the UPRN. An assistant with the MarketCode skills installed does both steps on its own.
Which assistants can run `property_lookup`?
+
Any MCP client: Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT in developer mode, Codex and Cursor, each documented on the MCP page. You sign in with your MarketCode account over OAuth; there is no key to paste, and the connection is read-only.
Where does the data come from?
+
Read from HM Land Registry ownership registers, Ordnance Survey AddressBase, Ordnance Survey NGD, Valuation Office Agency council tax list and Ministry of Housing, Communities and Local Government EPC register. Coverage is Great Britain for the address; England and Wales for most tiers; England for designations.
Can I store or republish the results?
+
The response includes records we license from HM Land Registry, Ordnance Survey, Valuation Office Agency and Ministry of Housing, Communities and Local Government. Use them in your own analysis, reports and products; bulk redistribution of the raw records or building a competing dataset from them is not covered. Ask us if you need a redistribution licence.
Does `property_lookup` change anything?
+
No. The tool is annotated read-only on the server, so it never writes to your data or ours and an assistant can call it without a confirmation step.
How is this different from the summary?
+
The summary is the headline attributes in one call for 4 credits. This is every field, in tiers, with a source and a confidence on each, for 5. If you will read more than a handful of fields, or you need to know where a field came from, call this.
What is in the provenance tier?
+
For each populated field, a _source naming the dataset it came from and a _confidence grading how certain the match or measurement is. It is what lets the platform say "trust this cell" rather than "trust this row".
Can I get this for a whole building?
+
One UPRN at a time; the building tier of each record names the building and its unit mix, and building_physical takes a list of UPRNs and returns the physical form of the buildings they sit in for 3 credits.
Try property_lookup in your assistant.
30-minute call. We'll connect your assistant live on a real address.