Property lookup
GET /v1/property/{uprn}Everything 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 MCP
Full property recordproperty_lookupAuthenticate with an API key from the API & MCP Hub. The same call is available as an MCP tool at the same price.
Reference
What GET /v1/property/{uprn} returns
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.
Request
Calling GET /v1/property/{uprn}
curl "https://api.marketcode.ai/v1/property/200003448393" \
-H "Authorization: Bearer $MARKETCODE_API_KEY"Send your API key as a Bearer token. Every response carries credits_charged and credits_remaining.
Inputs
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| uprn | Path | 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.
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
Endpoints 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 - Council tax bandFree
council_tax_bandVOA council tax band for a property, from the official list.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.
How do I authenticate?
+
Send your API key as a Bearer token in the Authorization header. Keys are created in the API & MCP Hub, shown once and revocable. Every response carries the credits charged and your remaining balance.
Is there an MCP version?
+
Yes. The property_lookup tool on the MarketCode MCP server is the same call at the same price, signed in with OAuth rather than a key, so Claude, ChatGPT, Codex and Cursor can run it in a conversation.
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 on a real address.
30-minute call. We'll provision a key and walk through the endpoint on your use case.